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PREFACE 


C 


This book describes the internal logic of OS/VS2 catalog management and 
contains diagnostic information. It is directed to maintenance personnel and 
development programmers who require an in-depth knowledge of catalog 
management’s design, organization, and data areas. 


Organization of This Book 
This book has the following major divisions: 


e “Introduction,” which describes catalog management and explains how 
, catalog management interacts with the operating system. 


e ‘Method of Operation,” which describes the functions performed by 
catalog management. 


e “Program Organization,” which describes the information contained in 
catalog management program listings and illustrates the flow of control 
between modules. 


e “Directory,” which lists catalog management modules and the Method of 
Operation diagrams and Program Organization compendiums that are 
related to each module. 


e ‘Data Areas,” which describes control blocks used by catalog management 
and describes the format of catalog records. 


e “Diagnostic Aids,” which contains useful information for locating the 
Cc cause of problems in the catalog management modules. 


e “Glossary,” which defines terms relevant to catalog management and lists 
abbreviations and acronyms used in this book and in the catalog 
management program listings. 


e “Index,” which is a subject index to the book. 


Required Reading 
The following books should be read and understood before using this one: 


¢ OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide, 
GC26-3838, which introduces VSAM concepts and contains definitive 
explanations of VSAM macro instructions. 


e OS/VS2 Access Method Services, GC26-3841, which describes the 
commands used to recover catalogs and process catalog and catalog 
¢ recovery area (CRA) records. 
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Other IBM Publications Referenced 
« OS/VS Data Management Macro Instructions, GC26-3793 


e OS/VS Mass Storage System (MSS) Services for Space Management, 
GC35-0012 


e OS/VS Mass Storage System (MSS) Services Logic, SY35-0015 
¢ OS/VS Message Library: VS2 System Messages, GC38-1002 


¢ OS/VS Virtual Storage Access Method (VSAM) Options for Advanced 
Applications, GC26-3819 


¢ OS/VS2 Access Method Services Logic, S¥35-0010 
| « MVS Data Areas Usage Table, SYB8-0742 

¢ OS/VS2 DADSM Logic, SY26-3828 

e OS/VS2 Data Areas, SYB8-0606 

e OS/VS2 JCL, GC28-0692 

« OS/VS2 Open/Close/EOV Logic, SY26-3827 


«© OS/VS2 MVS Resource Access Control Facility (RACF): General 
Information Manual, GC28-0722 


* OS/VS2 System Programming Library: Service Aids, GC28-0674 


« OS/VS2 System Programming Library: System Generation Reference, 
GC26-3792 


© OS/VS2 System Programming Library: System Management Facilities, 
GC28-0706 


© OS/VS2 Virtual Storage Access Method (VSAM) Logic, SY26-3825 
| © OS/VS2 System Programming Library: Data Management, GC26-3830 


Using This Book 


This book is designed to be used with the catalog management program 
listings. The diagrams in “Method of Operation” describe the major functions 
performed by catalog management. These diagrams are intended to be your 
key to a module name (and procedure name, as appropriate) in the listing. See 
“Introduction” for a description of how to read these diagrams. For 
information on what is available in the program listings, see ““Program 
Organization.”’ 
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SUMMARY OF AMENDMENTS 


July, 1978 


This technical newsletter incorporates and replaces all previous SU 
information in this publication. 


OS/VS2 MVS Data Management Support Selectable 


Unit (5752-860) 


A common password/bypass function is provided in SCRATCH and 
RENAME. HSM will use this function while copying and restoring data sets 
to migration storage from public storage and vice versa. 


OS/VS2 MVS Data Management (VS2.03.808) 


Extended CVOL Support 


Improved Catalog Recovery 


In OS/VS2 MVS Release 2, the VSAM catalog replaced the system master 
catalog and support of OS CVOLs was limited to a subset of what had been 
provided in OS/VS2 SVS Release 1. Extended CVOL support provides a 
CVOL function that is equivalent to SVS while retaining the VSAM master 
catalog as the only system master catalog. This support required that changes 
be made to Diagrams AA1, CA1, and DB1. 


A brief description of the Access Method Services RESETCAT command has 
been added to the introduction of this publication. No technical changes were 
required. RESETCAT is used to reset a catalog to the level of its owned 
volumes without moving data, and the command is described in OS/VS2 
Access Method Services. 


OS/VS2 MVS Supervisor Performance #2 (VS2.03.807) 


Resource Access Control Facility 


Resource Access Control Facility (RACF) is an IBM program product that 
provides additional access-control measures. The Catalog Management 
interface to RACF has been added to this publication. Specifically: 


e Change Method of Operation Diagrams DD1, DD2, DG1, EC1, EH2, and 
EJ3 


e Change Program Organization Figures 18 and 19 


e Add new Program Organization Figures 38.1 - 38.9 to describe Catalog 
Management RACF functions 


e Add a security flags field to the Data and Index, Cluster, Alternate Index, 
and Path Catalog Records 


e Add new fields and bit settings in the ACB, the CAXWA, the CTGFV, 
and the CTGPL 
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Catalog RPL Limit 


Catalog RPL Limit is an improved method of handling catalog RPLs. An J 
incoming request unable to obtain an RPL now will issue the WAIT macro for 

a free RPL. When an in-process request frees an RPL, it will issue a 

cross-memory POST macro on the waiting request’s ECB. Changes to 

support this function include: 


e« New fields and bit settings in the CAXWA and the CCA 


« IGGPACI, IGGPCDSO, IGGPPCCP, and IGGPSC2 have been moved 
from IGGOCLA3 to IGGOCLAH t 


« IGGPCSCP, IGGPCVX, IGGPDOG, and IGGPDPCC are now 
designated external procedures in IGGOCLA3 . j 


Support for ASM Rewrite 


The support for ASM rewrite allows the defining and preformatting of Swap 
spaces and treats SYS1.STGINDEX< as a system data set. The changes are: 


« A new bit setting in the ATTR2 field of the Data and Index Catalog 
Record describes an internal system data set 


« A new bit setting in the CATTR field of the Cluster Catalog Record 
indicates a cluster that describes a SWAPSPACE 


Release 3.7 
Recoverable Catalog Support e 


Catalogs can be defined with an optional recovery attribute that allows data 
sets to be recovered or restored. Recovery is based on information that is 
recorded in the catalog and also in a catalog recovery area on the volumes 
owned by the catalog. 


Recoverable catalog support changes the format of the catalog record, and 
adds a new Method of Operation diagram, a new catalog record, and new 
fields to various catalog control blocks. 


Catalog Unload/Reload 


Catalog Unload/Reload, a part of the Access Method Services REPRO 
command, is a high-performance option used to back-up VSAM catalogs that 
do not have the recoverable attribute. 


Enhanced VSAM : 


Extensive changes have been made throughout this publication to describe 
Catalog Management’s support of Enhanced VSAM’s functions and data 
structures, including alternate indexes, spanned records, relative record data 
sets, and reusable data sets. 


Most Method of Operation diagrams have been changed; new diagrams 

describe the catalog processing required when (1) an alternate index or path 

is defined or deleted, (2) the VSAM object to be processed is reusable, and 

(3) aSHOWCAT macro instruction is issued. > 
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All Program Organization figures have been changed. Flowcharts describing 
catalog and catalog recovery area I/O functions have been given figure 
numbers to make then easier to identify and locate. 


The Data Areas section includes four new catalog record types: alternate 
index, path, upgrade, and catalog recovery area records. Changes have been 
made to most control blocks to accomodate the new functions and structures. 


e The “Method of Operation” section contains a description of 
CONVERTYV processing for converting data stored on a direct-access 
storage volume to a mass storage volume, or vice versa, with the IBM 3850 
Mass Storage System. 


e The “Method of Operation” section contains a description of ALTER 
REMOVEVOLUMES processing for taking away VSAM ownership of a 
volume without gaining access to the catalog that owns the volume. 


e Other sections contain miscellaneous information: program organization 
description for CONVERTYV, directory entries, data areas, messages, 
macros, error codes. 


e OS/VS2 (VSAM) Catalog Management replaces OS/VS Catalog 
Management as the system catalog management component. The 
“Introduction” describes the interactions between OS/VS catalog 
management and various system components. 


e The “Introduction” and ‘‘Method of Operation” sections include 
descriptions of enhancements to VSAM catalog management—aliases, 
generic names, generation data groups, and copying a catalog. 
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INTRODUCTION 


OS/VS2 catalog management uses VSAM to read and write catalog records 
on a direct-access storage device. Virtual Storage Access Method (VSAM) is 
an access method for use with OS/VS2. VSAM is used with direct-access 
storage to provide fast storage and retrieval of data. 


Catalog records are built and stored in the VSAM record format. VSAM’s 
record format is different from that of other access methods. All VSAM 
records are stored in control intervals. A control interval is a continuous 
segment of auxiliary storage. The records are ordered according to values in a 
key field (key-sequenced), when they were stored (entry-sequenced), or 
where they were stored (relative record). With key-sequenced data sets, the 
user can gain access to a record by specifying either its key or its relative byte 
address (RBA). With entry-sequenced data sets, the user can gain access to a 
record only by specifying its RBA. With relative record data sets, the user can 
gain access to a record by specifying its relative record number. For additional 
information on VSAM records and how they are stored, see ‘‘Data Areas” in 
OS/VS2 VSAM Logic. 


OS/VS2 catalog management resides in the pageable link pack area. Figure 1 
illustrates VSAM’s relationship to OS/VS, the processing program, and the 
data stored on a direct-access storage device and in mass storage. 


Virtual Storage 


Direct-Access 
Storage 


Physical Data 


Logical 
Data 
Staged 
Data 


Mass Storage 


Program’s Address Space 


Figure 1. Relationship of VSAM, OS/VS, User’s Processing Program, and Staged Data 


VSAM is controlled by user macro instructions. For information on VSAM 
user macro instructions, see OS/VS Virtual Storage Access Method 
(VSAM) Programmer’s Guide and OS/VS Virtual Storage Access Method 
(VSAM) Options for Advanced Applications. 


VSAM communicates with other parts of the operating system through the 
SVC processor and through OS/VS control blocks used by VSAM. In 
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addition to the OS/VS control blocks used by VSAM, VSAM builds and uses 
the access method control block (ACB). The ACB describes a VSAM data 
set in much the same way that a DCB describes a nonVSAM data set. See 
OS/VS2 VSAM Logic for a more detailed description of the VSAM access 
method. 


In addition to processing records and data sets, VSAM opens and closes data 
sets and does most of its own space management. That is, VSAM makes only 
minor use of OS/VS Open and Close and relies on OS/VS DADSM 
(direct-access device space management) for only part of its space 
management. To do much of this work, VSAM uses the OS/VS2 master 
catalog and user catalogs. OS/VS2 catalogs contain a description of VSAM 
space—where available space is and how space is used—and the location of 
data sets. 


Using Catalog Management 


OS/VS2 catalog management is used to locate and update information in an 
OS/VS2 catalog. When an OS/VS component requests information from an 
OS/VS2 catalog, the component builds a CTGPL (catalog parameter list) to 
describe the request and CTGFLs (catalog field parameter lists) to describe 
specific fields of information needed to satisfy the request. The component 
then issues CATLG, a macro instruction that results in SVC 26, with register 
1 pointing to the CTGPL. Only OS/VS components and Access Method 
Services issue CATLG. User programs have no direct interface with catalog 
management. 


Existing user programs issue CAMLST to build an OS/VS catalog processing 
parameter list, then issue SVC 26 to call OS/VS catalog management. The 
catalog controller interprets the CAMLST and builds a CTGPL and CTGFLs 
(see Diagram CA1, Catalog Controller Processing, for details.) The user’s 
program can also build a CTGPL and CTGFLs, then issue SVC 26, to 
process catalog record information. 


JOBCAT and STEPCAT DD Statements 


The master catalog is assumed to contain the definition of the data set 
described in a DD statement if no user catalog is indicated or if the definition 
is not found in the user catalog(s) that are indicated. A user catalog can be 
specified for all steps of a job (with a JOBCAT DD statement) or for a 
particular job step (with a STEPCAT DD statement). 


The order in which OS/VS2 catalog management searches catalogs for a data 
set is: 


1. Any user catalog(s) specified for the current job step. 


2. Any user catalog(s) specified for the current job, only if no user catalogs 
are specified for the job step. 


3. A dynamically opened catalog, identified by 
e catalog DSNAME, or 
e first qualifier of a data set’s qualified DSNAME 


4. The master catalog. 
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C 


OS/VS Scheduler 


If a job step contains no STEPCAT DD statements, but the job contains a 
JOBCAT DD statement, the OS/VS Scheduler designates the JOBCAT 
catalog(s) as STEPCAT catalog(s) for the job step. 


The OS/VS Scheduler analyzes the user’s job control language statements. 
When a JOBCAT or STEPCAT DD statement is found, the user has specified 
a catalog that contains information about a data set his job intends to access. 
The OS/VS Scheduler opens each catalog specified by the user before 
allowing the user’s program to begin processing. When the user’s program 
completes processing, the OS/VS Scheduler closes each catalog opened for 
the user. 


OS/VS VSAM Open/Close /End-of -Volume 


VSAM Open: When a user’s program issues the OPEN macro instruction to 
open a VSAM data set (each VSAM data set is cataloged in an OS/VS2 
catalog), VSAM Open processing calls OS/VS2 catalog management to 
obtain information about the data set. If the data set is a key-sequenced 
VSAM data set, for example, the information returned by catalog 
management includes: location of each extent of the data set and its index, 
attributes of the data set, data set statistics (the contents of the AMDSB 
control block when the data set was last closed), key range information, and 
password information. If the data set is a nonVSAM data set, OS/VS2 
catalog management returns the volume serial number and device type of the 
volume containing the data set. 


VSAM Close: When a user’s program issues the CLOSE macro instruction to 
close a VSAM data set (cataloged in an OS/VS2 catalog), VSAM Close 
processing calls OS/VS2 catalog management to update the data set’s 
Statistics in the catlaog. 


VSAM End of Volume: VSAM End of Volume processing is called by VSAM 
Record Management when either of the following occurs: 


« A write operation failed because there is no more space allocated to the 
VSAM data set. 


e A read operation failed because the desired record is on an unmounted 
volume. 


VSAM End of Volume processing calls catalog management to obtain 
additional space or to obtain the volume’s serial number and characteristics. 
When additional space is obtained for the data set, catalog management 
updates records that describe the data set and that describe the volume 
containing the space. 


OS/VS Access Method Services 


Access Method Services is a service program that allows VSAM users to 
catalog and uncatalog VSAM data sets. Access Method Services commands 
that result in a direct call to OS/VS2 catalog management are: 


DEFINE Catalog an object in an OS/VS2 catalog 
ALTER Modify information in a catalog record 
DELETE Uncatalog an object from an OS/VS2 catalog 
LISTCAT Print catalog information 

CONVERTV Convert a volume to or from mass storage 
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DEFINE is used to build a catalog record (or group of catalog records) that 
describes the object—a VSAM cluster, a nonVSAM data set, an alternate 
DSNAME, a generation data group, a VSAM data space, an OS/VS2 
catalog—being created or cataloged. 


ALTER is used to modify information within certain types of catalog records. 


DELETE is used to uncatalog an object that is described by a catalog record. 
If the object has space allocated to it, the space is returned to the OS/VS 
system. 


LISTCAT is used to obtain a printout of information contained in 
caller-specified types of catalog records. 


CONVERTYV is used to convert a direct-access storage volume to a mass 
storage volume, or vice versa. That is, data that is stored on one type of 
volume is stored on the other type, and catalog volume information is updated 
to record the change. For additional information on this command, see 
OS/VS2 Access Method Services and OS/VS Mass Storage System 
(MSS) Services for Space Management. 


OS Catalog Management 


Certain commands issued for OS catalog management are converted into 
OS/VS2 catalog management requests and processed against OS/VS2 
catalog records. 


Creating the OS/VS2 Master Catalog 


The OS/VS2 master catalog is created during the system generation process 
(SYSGEN). The master catalog is identical to a user’s catalog, except that it is 
identified by a record in the SYS1.NUCLEUS data set. See Diagram BA1, 
Opening the Master Catalog, for details about the relationship of the master 
catalog to the OS/VS2 system. 


When SYSGEN occurs, the OS/VS2 master catalog is created. The SYSGEN 
process builds three series of job steps that build the master catalog: 


1. The Access Method Services command DEFINE CATALOG is issued to 
build an OS/VS2 catalog. See Diagram EE, DEFINE CATALOG: Create 
an OS/VS2 Catalog, for details on the catalog creation process. 


The SYSGEN starter system includes a master catalog, called the 
functional system master catalog. The master catalog for the system being 
generated is called the target system master catalog, and is pointed to by a 
User Catalog catalog record in the functional system master catalog. 
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2. All system data sets are defined in the catalog. 


A. The Access Method Services command DEFINE NONVSAM is issued 
to define each nonVSAM data set. See Diagram EF1, DEFINE 
NONVSAM: Define a NonVSAM Data Set In an OS/VS2 Catalog, for 
details on the define nonVSAM process. The system data sets defined in 
the catalog are: 


SYSI.BRODCAST SYS1.LOGREC SYS1.SAMPLIB 
SYS1.CMDLIB SYS1.LPALIB SYS1.SVCLIB 
SYS1.DCMLIB SYS1.MACLIB SYS1.SYSJOBQE 
SYS1.DSSVM SYS1.MANX SYS1.SYSVLOGX 
SYS1.DUMP SYS!.MANY SYS1.SYSVLOGY 
SYS1.HELP SYS1].NUCLEUS SYS1.TELCMLIB 
SYS1.IMAGELIB SYS!1.PARMLIB SYS1.UADS 
SYS1.LINKLIB SYS!1.PROCLIB SYSI.VVIC 


B. The Access Method Services command DEFINE CLUSTER or 
DEFINE PAGESPACE is issued to define each VSAM data set or 
paging space. See Diagram ED, DEFINE CLUSTER: Create a Cluster, 
for details on the Define Cluster process. The VSAM system data sets 
defined in the catalog are: 


SYS1.STGINDX 
Paging spaces 


C.If the user provided DSNAMEs of nonVSAM and VSAM data sets to 
be included in the OS/VS2 master catalog, the DEFINE NONVSAM 
and DEFINE CLUSTER commands are issued to define each 
user-specified data set. 


3. The SYS1.NUCLEUS data set (in the nucleus being generated) is updated 
with a record, labelled “SYSCATLG”’, that describes the OS/VS2 master 
catalog’s location—its volume serial number. The catalog volume’s VTOC 
contains a DSCB identified by the name ‘‘Z9999994.VSAMDSPC. 
Taaaaaaa. Tbbbbbbb’’, where “‘a” and “‘b”’ are digits of the timestamp. The 
DSCB describes the space containing the first extent of the catalog’s 
low-key range. This part of the catalog contains the catalog’s 
self-describing records in the first fourteen control intervals. See “Catalog 
Records That Describe the Catalog” for a description of the self-describing 
catalog records. See “‘Catalog”’ for a description of the OS/VS2 catalog. 
Both of the above references are in the “Introduction,” and immediately 
follow. 


For further information on system generation and the OS/VS2 master catalog 
creation process, see OS/VS2 System Programming Library: System 
Generation Reference. ° 
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Catalog 


OS/VS2 catalogs—the master catalog and any user catalogs—are built and 
processed by catalog management modules. Catalog management modules, 
via the catalog, enable a user to locate a data set, volume, index, or cluster by 
specifying a data set’s dsname or volume serial number. In addition, OS/VS2 
catalogs provide VSAM with the information required to allocate space for 
data sets, verify authorization to gain access to data sets, compile usage 
Statistics on data sets, and relate RBAs to physical locations within data sets. 
The catalog indicates, therefore, much more than the simple location of data 
sets. The catalog maintains the relationship between a key-sequenced data set 
and its index, describes the !ocation of VSAM data spaces and the data sets 
that reside in them, and describes the space that is available for new data sets. 


The catalog is conceptually a key-sequenced VSAM data set divided into two 
key ranges called the low-key range and the high-key range. VSAM data set 
processing options, such as index record replication and sequence set with 
data, are utilized in both parts of the catalog. The catalog record size is 
variable; the catalog control interval size is 512 bytes. Figure 2 shows an 
OS/VS2 catalog. The figure shows: 


e« The low-key range of the catalog, shown on the left, contains records that 
describe generation data groups, alias names, and objects—data sets, 
indexes, alternate indexes, paths, upgrade sets, volumes, and clusters. 


e The high-key range of the catalog, shown on the right, contains the true 
name (a data-set name, cluster name, or volume serial number) of an 
object specified by the user. 


e The index, shown in the middle, points to both the low- and high-key 
ranges of the catalog. 


With the exception of catalog records that are built when the catalog is 
created and describe the catalog itself, catalog records are built whenever 
objects are cataloged. The order that records are in depends upon which 
portion of the catalog the records belong to. The catalog records that reside in 
the low-key range of the catalog are ordered according to control interval 
number. As objects are cataloged, available control intervals are used. The 
catalog records that reside in the high-key range of the catalog are ordered 
according to their true name (cluster dsname or volume serial number). 


Catalog management relies on VSAM record management for all record 
retrieval and storage. When a user specifies a data set name, for example, 
record management uses the index to retrieve a catalog record that contains 
the data-set name (in the high-key range of the catalog); that record, in turn, 
contains the control-interval number of the catalog record that describes the 
data set. Catalog management converts the control-interval number to an 
RBA in the low-key range of the catalog. 


High-Key Range of the Catalog 


The high-key range of the catalog contains 47-byte True Name records in 
512-byte control intervals. The True Name records associate user-specified 
names or volume serial numbers with the control-interval number of the 
catalog record that describes the specified object. 
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Low-key range High-key range 
catalog records true-name entries 


( Figure 2. Parts of an OS/VS2 Catalog 


Low-Key Range of the Catalog 


Records in the low-key range are 505 bytes long. Each record resides in its 
own control interval. Each record also contains its record type. The low-key 
range of the catalog is made up of the following types of records: 


e Alias record, which relates an alternate DSNAME (alias) of a nonVSAM 
data set or user catalog to the data set’s or user catalog’s catalog record. 
This record is record type ‘‘X.”’ 


e Alternate index record, which relates the alternate index to its associated 
base cluster and also to any paths over it. This record is record type ‘‘G.”’ 


e Cluster record, which describes a VSAM data-set cluster or pagespace 
(conceptually an entry-sequenced VSAM data set). This record contains 
the control-interval number of a Data record and, if the VSAM data set is 
a key-sequenced data set, the control-interval number of an Index record. 
There is one Cluster record for each VSAM cluster cataloged. This record 
is record type “C.” 


e Control record, or CCR, which describes the free control intervals in the 
low-key range of the catalog. The Control record is the fourth record in the 
catalog. This record is record type “‘L.” 


e Data and Index records, which describe data sets and indexes. A Data 
record can also describe a pagespace (conceptually an entry-sequenced 
VSAM data set). There is one Data or Index record for each data set or 
C index cataloged. These records are record types ‘“‘D”’ and “I.” 
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e Extension record, which contains overflow information from another 
catalog record. There are as many Extension records as are required to 
contain overflow information. This record is record type ‘“W” when it is an 
extension of a Volume record; it is record type “‘E” when it is an extension J 
of any other catalog record. 


e Free record, which marks the control interval in which it resides as 
available for use as another kind of catalog record. There is one Free 
record for each previously assigned control interval that is available for 
use. This record is record type “F.” 


e Generation data group base record, which contains the control interval 
number and generation level (absolute name) of each generation data set 
in the group. This record is record type ‘‘B.” 


e NonVSAM record, which describes a nonVSAM data set. There is one 
NonVSAM record for each nonVSAM data set cataloged. This record is 
record type ‘“‘A.” 


e Path record, which relates a base cluster and possibly an alternate index. 
This record is record type “‘R.”’ 


¢ Upgrade set record, which relates the data components and index 
components of the alternate indexes that comprise the upgrade set. This 
record is record type “‘Y.”’ 


e User-Catalog record, which describes a VSAM user catalog. There is one 
User-Catalog record for each user catalog connected to this master catalog. 
This record is record type “‘U.”’ 


¢ Volume record, which describes each VSAM data space on a volume, the 
data sets that reside in the data space, and the space available within the 
data space. There is one Volume record for each volume controlled by this J 
catalog. This record is record type “V.”’ 


The Cluster, Data, Index, Alternate Index, Path, Upgrade Set, NonVSAM, 
Extension, Alias, GDG Base, and User-Catalog records have a common 
general format. See the ““Data Areas” section for a figure that shows the 
general format of these records. 
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Catalog Records That Describe the Catalog 


Catalog records that describe the catalog as a data set are in fixed positions at 
the beginning of the catalog. The following table shows the control-interval 
numbers of records that describe the catalog, the kind of catalog record each 
is, and the contents of each. 


Control 
Interval Record 
Number Type Contents 

0 Data Set Description of the data portion of the catalog (low-key range 
and high-key range). 

1 Index Description of the index portion of the catalog. 

2 Cluster Description of the catalog as a key-sequenced VSAM cluster. 
This catalog record contains the catalog’s password 
information set of fields. 

3 Control Catalog control record (CCR), which describes the catalog’s 
free control intervals within the low-key range. 

4 Extension Extension of the index catalog record (control interval 
number 1). This Extension record contains a description of 
the high-level index extents of the catalog. 

5 Extension Extension of the data set catalog record (control interval 
number 0). This Extension record contains a description of 
the low-key range data extents of the catalog. 

6 Extension Extension of the index catalog record (control interval 
number 1). This Extension record contains a description of 
the index sequence-set extents for the low-key range of the 
catalog. 

7 Extension Extension of the data set catalog record (control interval 
number 0). This Extension record contains a description of 
the extents of the True Name records in the high-key range of 
the catalog. 

8 Extension Extension of the catalog’s index catalog record (control 
interval number 1). This Extension record contains a 
description of the index sequence-set extents for the high-key 
range of the catalog. 

9 Volume Description of the track allocation and VSAM data spaces on 
the volume containing the catalog. 

10-13 Volume As many volume extension records as are necessary to 


Extension describe the total space on the volume. These extension 
records contain the volume record’s space map set of fields. 


When the catalog is built, there are two True Name records. One contains the 
catalog’s volume serial number and points to control interval number 9. The 
other contains the catalog’s dsname and points to control interval number 2. 


Alternate Names (Aliases) 


An alias is an alternate DSNAME for a nonVSAM data set’s or user 
catalog’s DSNAME. Any of the 44 characters of the data set or catalog name 
can be different in the alias. The user creates an alias by using the Access 
Method Services DEFINE command to build an alias-name catalog record 
that contains the alias and points to the data set’s (or catalog’s) catalog 
record. No passwords are required to modify or delete alias catalog records. 
The alias user-catalog name capability allows many users to refer to the same 
catalog—each user can specify a different alias user-catalog name. 
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Generation Data Groups 


A generation data group (GDG) is a collection of nonVSAM data sets that 
have a common external name, and that are related by the time sequence in 
which they are cataloged (that is, their generation). For example, a data set 
named LAB.PAYROLL(0) refers to the most recent data set of the group. 
LAB.PAYROLL(—1) refers to the second most recent, etc. The number in 
parentheses is called the relative number of a specific generation. 


When a user locates a generation data set by specifying a relative DSNAME 
(dsname(n)), catalog management replaces the relative number (n) with an 
absolute name. The absolute name is the simple name of the data set. The 
absolute name has the general form GnnnnVmm, where nnnn is the 
generation number and mm is the version number. If the relative number is 
zero, the last generation data set cataloged is retrieved. If the relative number 
is minus One, the next to last generation data set cataloged is retrieved. If the 
relative number is a positive number, catalog management will compute the 
absolute name by adding the user-specified relative number to the absolute 
name of the last (highest) generation cataloged. The user can also specify the 
absolute name to be used as a reference instead of the last (highest) 
generation cataloged. 


The user creates a generation data group by using the Access Method Services 
DEFINE command to build a generation data group base catalog record. 
There is one GDG base catalog record in the catalog for each GDG. Each 
GDG base catalog record contains a list of absolute names in sequential order 
for those generation data sets which are members of this group. Since the 
OS/VS2 catalog does not contain an OS catalog index structure to support 
GDG processing, the user must issue the Access Method Services DEFINE 
command to create each GDG base record. 


Password Protection 


VSAM passwords control the right to use VSAM data sets. VSAM passwords 
restrict unauthorized usage of OS/VS2 catalogs, clusters, data sets, and 
indexes. If an OS/VS2 catalog or cluster is protected by passwords, the 
passwords are contained in a password set of fields in the cluster, data set, 
alternate index, path, or index catalog record. 


Passwords are initially defined when the user issues the Access Method 
Services DEFINE command to create a catalog or VSAM cluster. The user 
can issue the Access Method Services ALTER command to change a catalog’s 
or cluster’s passwords when the user supplies the catalog’s or cluster’s master 
password. 


When an unauthorized user attempts to access a password-protected catalog 
or cluster and is unable to supply the correct password, catalog management 
sets an error return code in the user’s ACB and writes an SMF (System 
Management Facilities) security violation record. 


A user can specify additional security verification by defining a USVR (User 
Security Verification Routine) when the catalog or cluster is created. If a 
USVR is specified for a catalog or cluster, the USVR is processed when the 
catalog management security verification processing completes sucessfully. 
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A privileged user of catalog management bypasses security verification. 
Privileged users include the OS/VS Scheduler and OS/VS Open/Close/EOV 
processing. OS/VS Checkpoint/Restart is not privileged and does not bypass 
security verification. 


Levels of Password Protection 


Master Password 


Control Interval Password 


Update Password 


Read-Only password 


The password set of fields contains four levels of password protection: 
master, control interval, update, and read-only. If any level of password is null 
(the password doesn’t exist), operations requiring that level of password 
protection can be performed without requiring the user to supply a password. 
When the user supplies a password for one level, any operation requiring that 
level and lower levels of password protection can be performed. 


The master password is the highest in the password hierarchy. The catalog’s 
master password is required to modify or delete any password-protected 
catalog record, to retrieve any password in the catalog, or to open the catalog 
as a data set. Since all passwords reside in OS/VS2 catalogs, a 
password-protected catalog record is a VSAM cluster, data set, index, alternate 
index, or path catalog record that contains a password set of fields. If the user 
supplies a cluster’s master password, his program can modify the data set and 
index catalog records and retrieve their passwords. 


The control interval password is the second highest level in the password 
hierarchy. The control interval or master password of a password-protected 
VSAM cluster, data set, index, alternate index, or path is required when the 
user opens the object for control interval processing. 


The update password is the third password in the password hierarchy. The 
catalog’s update or higher level password is required when the user issues an 
Access Method Services DEFINE command to create a VSAM object and/or 
add a catalog record to the catalog. Even though the new catalog record 
doesn’t contain a password set of fields, the user must still supply the 
catalog’s update or higher password. The catalog’s update or higher level 
password is also required to delete a volume catalog record. The cluster’s 
update or higher level password is required to open a password-protected 
VSAM cluster for update processing. 


The read-only password is the lowest level in the password hierarchy. The 
catalog’s read-only or higher level password is required when the user issues 
an Access Method Services LISTCAT command to retrieve catalog record 
information, except passwords. The catalog’s master password is required to 
retrieve password information. The cluster’s read-only or higher level 
password is required when a user opens the cluster for read-only processing. 
When the user supplies an OS/VS2 catalog record’s read-only password, his 
program is allowed to retrieve information (except passwords) from the 
record. The record’s master password is required to retrieve password 
information. 
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Restrictions 


Only cluster, data set, index, alternate index, and path catalog records can 
contain a password set of fields. The catalog’s password set of fields is in 
control interval number 2—one of the catalog’s self-describing records. The 
other types of catalog records—nonVSAM, volume, user catalog, upgrade, 
GDG base, and alias name—do not contain a password set of fields. 


No password is required to: 


e Alter or delete a catalog record that doesn’t contain a password set of 
fields, except that the catalog’s update password is required to delete or 
alter nonVSAM catalog records. 


« Open a cluster described by a catalog record that doesn’t contain a 
password set of fields. 


« Add, alter, or delete catalog records in a catalog that is not protected by 
passwords. 


When a user issues LOC, an OS Catalog Management command, against a 
nonVSAM catalog record in an OS/VS2 catalog, no password is required. If 
the OS/VS2 catalog is protected by an update level password, the update 
level password or higher level is required when the user issues the CAT, 
UNCAT, or RECAT command. 


When IEHDASDR, an OS Utility program, attempts to access records in a 
VSAM data space, the user must supply the read-only password for each 
read-only password-protected data set in the data space. 


RACF Protection 


Resource Access Control Facility (RACF) provides software access control 
measures that you can use in addition to your present data security measures 
(such as TSO passwords or password-protected data sets). 


When RACF protection and password protection are both applied to a data 
set, password protection is bypassed, and use is authorized solely through the 
RACF checking system. 


RACF is described in OS/VS2 MVS Resource Access Control Facility 
(RACF) General Information Manual. 


Copying the Catalog 


A user can copy a catalog from one direct-access device to another. The 
original catalog is called the ‘‘source’’ catalog. The new catalog is called the 
target catalog. The target catalog contains volume catalog records that 
describe the target catalog volume’s direct-access device space. When the 
source catalog is copied into the target catalog, the target catalog contains 
volume catalog records that describe the source catalog volume’s direct-access 
device space. 


OS/VS2 Access Method Services describes the REPRO command, which is 
used to copy the catalog. However, the catalog copying procedure is more 
involved than issuing the REPRO command: 


1. The Access Method Services DEFINE CATALOG command is used to 
create a target catalog. The target catalog is created on a direct-access 
volume that contains no VSAM data spaces. 
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2. The Access Method Services REPRO command is issued to move each 
catalog record from the source catalog into the target catalog. 


Source catalog records are moved into the target catalog starting at the 
target catalog’s 14th control interval. Each source catalog record is 
scanned to find all referenced control interval numbers. Each control 
interval number in the source catalog record is updated (control interval 
number + 13) to reflect the referred-to record’s new location in the target ' 
catalog. 


IDACAT21 is called by the Access Method Services REPRO processing 
module to update the source catalog record’s control interval number 
references and to move the updated record into the target catalog. 


3. The Access Method Services EXPORT DISCONNECT command is issued 
to remove the source catalog’s User Catalog catalog record from the 
OS/VS2 master catalog. The source catalog can no longer be opened as a 
user catalog. 


4. The Access Method Services DELETE CLUSTER command is issued to 
delete the source catalog’s self-describing records in the target catalog. The 
source Catalog is described in the target catalog as a key-sequenced VSAM 
data set (control intervals 14 through 22 in the target catalog). Catalog 
management also modifies the source catalog volume’s VTOC so that the 
format-1 DSCB that pointed to the source catalog’s VSAM data space 
indicates that the data space doesn’t contain a catalog. 


The source catalog is effectively removed from the OS/VS2 system. Its 
space is marked “‘unallocated’’ in the target catalog and can be used to 
contain other data. 


Recoverable Catalog Support 


Catalogs can be defined with an optional recovery attribute that allows data 
sets to be recovered or restored. Recovery is based on information that is 
recorded in the catalog and also in a catalog recovery area on the volumes 
owned by the catalog. The recovery area is established when the recoverable 
catalog acquires ownership of the volume. Thus, all volumes owned by a 
recoverable catalog contain catalog recovery area space. 


Whenever records in a recoverable catalog are defined, deleted, or modified, 
the corresponding information in the catalog recovery area is updated to 
reflect the change. Although no specific commands are required to maintain 
the recovery area, certain volumes must be mounted during defines, alters, 
deletes, and any catalog entry modifications resulting from open, close, or end 
of volume activity. The volumes are: 


ALTER __ The prime catalog recovery volume for the objects being altered. 


DELETE All volumes that are referenced by the entry being deleted and the 
prime CRA volume. 


DEFINE All volumes that are referenced in the DEFINE command. Also, 
the first volume of the base cluster must be mounted when 
alternate indexes and paths are being defined. 


Once a recoverable catalog is defined, it cannot be made nonrecoverable. 
Also, a recoverable catalog cannot be copied. A nonrecoverable catalog can 
be converted and made recoverable through Access Method Services 
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commands. This conversion is not necessary unless there is a requirement for 
the recovery capability. 


The Access Method Services commands used to achieve catalog recovery are 
described in OS/VS2 Access Method Services. That book also contains 
specific instructions on how to make an existing master catalog recoverable. 
User catalogs can be converted by using the EXPORT, DELETE, DEFINE, 
and IMPORT commands. 


This publication contains additional information about catalog recovery. In 
the ‘Method of Operation” chapter, Diagram EE3 describes the processing 
required to define a catalog recovery area. In the “Program Organization” 
chapter, detailed drawings in the ‘‘Catalog Management I/O Functions” 
section illustrate CRA I/O operations. The “Data Areas” chapter contains 
the description and the format of all the recovery area records. 


Resetting a Catalog 


The Access Method Services RESETCAT command is used to reset a catalog 
to the level of its owned volumes without moving data. It merges the catalog 
records from specified catalog recovery areas with the records in the catalog. 
If the equivalent record exists in the catalog, it will be replaced in the catalog. 
If the equivalent record does not exist in the catalog, it will be inserted into it. 
If a record exists in the catalog which designates one of the specified CRA 
volumes as its CRA and no equivalent record exists in the CRA, that record 
will be deleted. 


RESETCAT is described in OS/VS2 Access Method Services. 


Catalog Unload/Reload 


Catalog unload/reload is a high-performance option used to backup and 
recover VSAM catalogs that do not have the recoverable attribute. (This 
function is not used with recoverable catalogs because CRA records are not 
modified during the reload process, and there are no assurances that CRA 
records and catalog records would be synchronized.) This option is part of the 
Access Method Services REPRO command. 


Catalog backup (unload) is performed by copying a VSAM catalog to a 
sequential access method (SAM) data set ora VSAM key-sequenced or 
entry-sequenced data set. This unloaded form of the catalog is available for 
subsequent reloading, but it cannot be used as a catalog while it is in the 
unloaded form. Unloading a catalog creates a data set that contains all of the 
catalog records as they existed at the time of the backup operation. 


Catalog recovery (reload) is performed by copying an unloaded catalog into 
an existing VSAM catalog. The existing catalog can be a newly defined 
catalog or it can be an earlier or later version of the unloaded catalog. A new 
catalog (same name, volume serial number, and device type) would be 
defined whenever the old catalog could not be opened for processing. An 
earlier or later version of the unloaded catalog might be obtained via a restore 
of the catalog volume. In both cases the reload operation creates a catalog 
equivalent to the catalog that was unloaded. 


The reload operation replaces any existing entries in the target catalog with 
entries from the backup copy. Entries in the backup catalog that are not on 
the target catalog are added. Entries that exist only in the target catalog are 
deleted. 
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Password protection of VSAM catalogs is optional. When a catalog is 
password-protected, the unload/reload option requires that the master 
password be provided for the catalog. The password can be supplied in the 
REPRO command or through the system console or TSO terminal. 


The frequency of catalog backup operations will determine the degree of 
success in any recovery operation. Frequent backup operations can be used to 
ensure that the latest backup copy closely matches the active catalog and 
reflects the data and its allocation on the volumes owned by the catalog. A 
wide difference between the backup catalog and the active catalog will 
increase the amount of manual intervention required to regain access to all of 
the data. 


For complete information about catalog unload/reload, see OS/VS2 Access 
Method Services. 


Catalog management branches to the ESTAE service routine to establish an 
ESTAE environment. When an error condition occurs, the catalog 
management recovery routine (IGGOCLAY) gets control from the System 
Recovery Termination Manager. 


The catalog management recovery routines receive control from System 
Recovery Termination management when the following types of errors occur: 
program checks, restart key interrupts, protection check of a user-supplied 
address, machine checks, and PSW restart. The recovery routines release all 
virtual storage that was obtained for the current request. OS/VS2 catalog 
management (IGGOCLA1) branches to the ESTAE routine. The ESTAE 
routine returns to the Catalog Controller, which issues SETRP to record the 
conditions for error analysis. 
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METHOD OF OPERATION 


A method of operation diagram describes one of the OS/VS2 catalog 
management functions by listing the process steps required to complete the 
function, and by showing the data required for each process step and the data 
produced by each process step. 


Reading Method of Operation Diagrams 


Method of operation diagrams are functional descriptions of catalog 
management. The diagram and descriptive notes, keyed to the diagram, are on 
facing pages. 


The diagrams contain three blocks of information: input, processing, and 
output. The left-hand side of the diagram shows the data that serves as input 
to the processing steps in the center of the diagram, and the right-hand side 
shows the data that is output from the processing steps. Input is anything a 
program function refers to or gets. Processing is the steps required to fulfill 
the function represented by the diagram. Output is any change effected by a 
function; for example, register contents, or control blocks created or 
modified. The processing steps are numbered; the numbers correspond to 
notes on the facing page. The notes include cross-references to the listings. 
Figure 3 shows a method of operation figure. 


The processing portion of the diagram shows the processing steps required to 
fulfill the function described by the diagram. Note that the function described 
by one diagram might be performed by one or more catalog management 
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Figure 3. Method of Operation Diagram 
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modules; that is, the diagrams describe functions, not physical parts of the 
program. 


The output created by each processing step is shown in the diagram. 


Reading the method of operation diagrams requires that you understand the 
symbols they use. Figure 4 shows the symbols and describes their meaning. 


LEGEND 
I Flow of control on the same page; =————— —> Reference to data or testing of 
‘3’ indicates a number of a process 5 oes ee as >) data by a process step; 11 is an 
> (3) step on the same page. arbitrary designation, 
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Figure 4. Graphic Symbols Used in Method of Operations Diagrams 
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Figure 5 shows part of the notes to Figure 3. 


Notes for Diagram AA1 


Catalog management is called when information in one of 
the catalogs available to the caller is needed to open, 
extend (obtain more space for), or close a data set. 
Catalog management is also called when information 
must be added to, deleted from, or modified within one of 
the catalogs. 


1 
Zz 


Figure 5. 


OS/VS Scheduler 
IEFAB4F5 


When the user's JCL DD JOBCAT or STEPCAT 
statements specify a user's (private) catalog, the 
OS/VS2 Scheduler calls IEFAB4F5 to open the user's 
catalog. See “Open Catalog Control Blocks,” a figure 
in the “Data Areas’ section that shows how the TCB. 
JSCB, and PCCBs are related to identify each open 
catalog available to the user's job. 


1GC0002F 


If the user has issued an OS catalog management 
request and has specified a CVOL volume serial 
number in the parameter list, then IGCOOQO2F exits to 
the CVOL Processor, IGGOCLCA, to process the 
request in the specified CVOL (see OS/VS2 CVOL 
Processor Logic). 


IGCO002F 


When the user issues an OS catalog management 
command without a CVOL volser, the command is 
translated to a OS/VS2 catalog management request 
and is processed by OS/VS2 catalog management 
routines. When the processing completes, the return 
code (and other information for the user's program, as 
applicable) is translated to an OS catalog management 
return code. 


Note: OS catalog management requests usually apply 
to NonVSAM, Alias, and GDG Base catalog records. 


IGGOCLAI 


When the user is an Access Method Services routine, a 
part of OS/VS82 catalog management, called “catalog 
management services , processes the request. Catalog 
management services routines are described in 
Method of Operations Diagrams EAI through EN 1 


When the user is a VSAM Open, Close, or End of 
Volume routine, OS/VS2 catalog management 
routines process the request. These routines are used 
to retrieve, add to, or update the information in 
catalog records. Catalog management services 
routines call the catalog management routines to 
manipulate catalog record information. Method of 


Operations Diagrams DAI through DM3 describe the 
OS/VS2 catalog management routines. 


Notes to Method of Operation Diagram 


The notes provide details about the processing shown in the diagram. 


The notes also name the modules and routines that perform the functions 
represented. The module and procedure names allow you to relate a process 
step to a unit of code in the catalog management program listings. 
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Diagram AA1. Catalog Management Overview 


OS/VS Scheduler processing 


JCL parameters 1. Is the required user’s catalog open for processing? 
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Notes for Diagram AA1 


Catalog management is called when information in one of 
the catalogs available to the caller is needed to open, 
extend (obtain more space for), or close a data set. 
Catalog management is also called when information 
must be added to, deleted from, or modified within one of 
the catalogs. 


1 OS/VS Scheduler 
2 IEFAB4F5 


When the user’s JCL DD JOBCAT or STEPCAT 
statements specify a user’s (private) catalog, the 
OS/VS2 Scheduler calls IEFAB4F5 to open the user’s 
catalog. See ““Open Catalog Control Blocks,”’ a figure 
in the “Data Areas” section that shows how the TCB, 
JSCB, and PCCBs are related to identify each open 
catalog available to the user's job. 


3 1GC0002F 


If the user has issued an OS catalog management 
request and has specified a CVOL volume serial 
number in the parameter list, then IGCO002F exits to 
the CVOL Processor, IGGOCLCA, to process the 
request in the specified CVOL (see OS/VS2 CVOL 
Processor Logic). 


4 1GC0002F 


When the user issues an OS catalog management 
command without a CVOL volser, the command is 
translated to a OS/VS2 catalog management request 
and is processed by OS/VS2 catalog management 
routines. When the processing completes, the return 
code (and other information for the user’s program, as 
applicable) is translated to an OS catalog management 
return code. 


Note: OS catalog management requests usually apply 
to NonVSAM, Alias, and GDG Base catalog records. 
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When the user is an Access Method Services routine, a 
part of OS/VS2 catalog management, called ‘‘catalog 
management services’, processes the request. Catalog 
management services routines are described in 
Method of Operations Diagrams EA1 through EN1. 


When the user is a VSAM Open, Close, or End of 
Volume routine, OS/VS2 catalog management 
routines process the request. These routines are used 
to retrieve, add to, or update the information in 
catalog records. Catalog management services 
routines call the catalog management routines to 
manipulate catalog record information. Method of 
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Operations Diagrams DAI through DM3 describe the 
OS/VS2 catalog management routines. 
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Diagram BA1. Opening the Master Catalog 


NIP processing: 


SYS1. NUCLEUS IEAVNIPM 
data set 


—_—=_ = the VSAM master catalog 


1. Retrieve the record describing the master catalog. 


Work area 


Volume 
serial 
number 


Device 
type 


CCHH of 
first catalog 


2. Is the master catalog’s volume mounted? 


7, No 

es 

- Pat ae cata 

eas — _ interva 
: ia 3. Mount the volume. 


Volume 


eet 4. Search the VTOC for the master catalog’s DSCB. oa el ould 
volume 
Master 5. Is the master catalog’s DSCB found? catalog 
Catalog’s Yes No 
Volume 
VTOC S 


Name = 29999994. 6. Terminate processing—put the CPU into 


-_ timestamp MATE Stauy: 


Build control blocks to describe the master catalog 


First ten 
catalog ees 
records 


(control 
intervals) 


. Retrieve the catalog’s self-describing records. 


. Build control blocks that describe the catalog to 
the OS/VS system. 


See “Open Catalog 
Control Blocks’”’ 


See ‘‘Catalog Data 


. Build control blocks that allow the OS/VS system 


Work area ” 
to read catalog records. 


CCHH of first 
catalog control 
interval 


Set Control 
Blocks’”’ 


. Connect the catalog to the OS/VS system. 


NIP processing: 
IEA VNIPM 


CVT 


tAMCBS 


+t Master 
catalog’s 
ACB 


S$¢ uoNeJadg Jo poy 


c | 


Notes for Diagram BAI 


The master catalog is opened when the OS/VS2 system is 
started—during NIP (the nucleus initialization 
procedure). When NIP finishes, the master catalog’s 
control blocks are freed (during a ““psuedo-close’) and the 
master catalog is opened a second time. The master 
catalog remains open as long as OS/VS2 is operational. 
The master catalog is never closed, even though it is 
conceptually described as a key-sequenced data set. 
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IEAVNIPM calls IEAVNP11 

IEAVNP11 

The SYS1.NUCLEUS data set contains a record, labeled 
“SYSCATLG”, that describes the master catalog’s 
location—its volume serial number. 

IEAVNP11 


Each mounted volume on the OS/VS system is 
described in one of the UCBs in the UCB table. 


IEAVNP11 


OS/VS issues a message to the operator to mount the 
volume containing the master catalog. 
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The volume’s table of contents (VTOC) contains a 
DSCB identified by the name 

*Z999999n. VSAMDSPC. Taaaaaaa. Tbbbbbbb’, where 
‘n’ is ‘4 or “6 and ‘a’ and ‘b’ are digits of the 
timestamp, that describes the space containing the 
first extent of the catalog’s low-key range. This part of 
the catalog contains the catalog’s self-describing 
catalog records in the first fourteen catalog control 
intervals. 
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The ACB, CAXWA, and AMCBS describe the master 
catalog to the OS/VS system. 


IEAVNP11 


The catalog is conceptually a key-sequenced VSAM 
data set divided into key ranges. 


10 IEAVNP11 


The address of the AMCBS is put into the CVT to 
connect the catalog control blocks to the OS/VS 
system control blocks. 
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For additional information about topics related to 
opening the OS/VS2 master catalog, see: 
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Diagram BP1. Opening A User’s Catalog 
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Notes for Diagram BB1 


A user's catalog is opened when one of the following 
conditions occurs: 


When the catalog’s DSNAME is specified in the user’s 
JCL JOBCAT or STEPCAT DD statements, the 
OS/VS Scheduler calls IEFAB4F5 to open the catalog 
before the user’s program begins processing. 


When an Access Method Services routine specifies a 
DSNAME that is in an unopened catalog, the catalog 
management search routine calls IEFAB4F5 to open 
the catalog. This process is called dynamic opening 
and occurs while the user’s program is processing. 


The user’s catalog remains open until all tasks that 
need to access the catalog have completed. When all 
tasks that use the user’s catalog are complete, the 
OS/VS Scheduler closes the catalog. 


When the OS/VS Scheduler opens and closes a user’s 
catalog, the process is similar in concept to a user's 
program opening and closing a key-sequenced data 
set. 


IGGOCLA3: IGGPACI 
IEFAB4F5 
IEFAB4F5 


The ACB and PCCB describe a user’s catalog to the 
OS/VS system. The ““Open Catalog Control Blocks” 
figure, in the ‘‘Data Areas” section, shows the control 
blocks that describe a catalog to the user program’s 
TCB. 


IEFAB4F5 calls IDACAT11 


The ACB is opened by issuing an OPEN macro 
instruction, resulting in SVC 19, that refers to the 
ACB. 


IEFAB4F5 calls IEFAB4EF 
IGGOCLA3: IGGPGPCC 


When a catalog is opened as a result of a catalog 
management request, the address of its ACB and 
PCCB 1s saved in the CCA. 


IGGOCLA3: IGGPGPCC 
IGGOCLA3: IGGPACI 


C 


For additional information about topics related to 
opening a user's catalog, see: 


“Data Areas:” 


Control Block Interrelationship Figures 
Open Catalog Control Blocks 
VSAM Control Blocks That Describe a Catalog 
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Diagram CA1. Catalog Controller Processing 


1. Obtain virtual storage for a workarea. 


Request decoding 


Ri 
tCAMLST > 2. Is the request an OS catalog management command? 
= _ No Yes 
CAMLST age v 
« _ e 2 Rl 
Describes an = 2.1 Is there a CVOL volume serial in the CAMLST? tCTGPL 
OS catalog No Yes 
management 
request ; CTGPL 
: 2.2 Exit to CVOL Processor (IGGOCLCA) to 
rocess this OS catalog management request. Describes an 
p g g a , OS/VS catalog 
management 
3. Translate the request intoan OS/VS2 catalog SII ZZ ZZ est 
o management request. Waciares 


Request type 


4. Record the request type. 


tCTGPL 


ohn > _~-S. Process the OS/VS2 catalog management request. 


See Diagram DB1—OS/VS2 
Catalog Management Overview 


Describes an 
OS/VS2 catalog 
management 

request 


DOREAIEE Final processing after return from OS/VS2 catalog management 
~~~ 
ees 6. Was the request an OS catalog management command? 


No Yes 


CCAPROB 


Return code (SS. 7. Translate a nonzero return code to the 


appropriate OS catalog management return code. 


8. Free the virtual storage obtained for a workarea. 


CCAPROB 


9. Return to the caller. 
~ u coge 


L 4 c u 
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Notes for Diagram CA1 


OS catalog management commands are used to process 
information in an OS system catalog. OS/VS2 catalog 
management can convert the OS commands and 
parameter lists to OS/VS2 catalog management 
commands and control blocks. 


1 


2 


IGC0002F 


(Receives control from dummy catalog module 
IGG026DU). 


IGC0002F: STRTCNTL 


When the caller issues a call to OS/VS2 catalog 
management, register 1 contains the address of a 
CTGPL—catalog parameter list. 


When the caller issues an OS catalog management 
command, register | contains the address of a 
CAMLSTD control block—a parameter list provided 
by the caller of OS catalog management. 


IGC0002F: STRTCNTL 


If the OS catalog management request includes a 
CVOL volume serial number in the parameter list, 
then IGC0002F transfers control to the CVOL 
processor (IGGOCLCA), which processes the request 
in a CVOL and returns directly to the caller (not to 
IG0002F). 


If no CVOL volume serial number is supplied, an OS 
catalog management request must be translated into 
an appropriate MVS catalog management request, as 
follows: 


OS Request MVS Request 
CATALOG DEFINE NONVSAM 
UNCATALOG DELETE NONVSAM 
RECATALOG ALTER NONVSAM 
LOCATE by name SUPERLOCATE 
INDEX(BLDA, BLDG, DUMMY DELETE 

BLDX, DLTA, 

DLTX, DRPX, 

LNKX) 


A DUMMY DELETE request is a standard MVS 
DELETE request with a zero data set type in the 
CTGPL (CTGTYPE=0). It causes MVS catalog 
management to find the proper CVOL for this INDEX 
request based on the first qualifier of the data set 
name. 


A LOCATE-by-block request without a CVOL volume 
serial specified will result in a return code of 4. 


C 


IGC0002F: STRTCNTL 


Before the OS/VS request is issued, the original 
request’s type (OS or OS/VS) is saved. 


IGC0002F XCTLs to IGGOCLA1 
IGG0102F (secondary entry point of IGC0002F) 


IGC0002F: RESMCNTL calls OSVOLST and 
OSRETCD 


IGC0002F 


For additional information about topics related to 
catalog controller processing, see: 


“Data Areas:” 


Catalog parameter list (CTGPL) description and 
format 


“Diagnostic Aids:” 
Catalog management return codes 


For additional information on dummy catalog module 
IGG026DU, see OS/VS2 System Programming 
Library: Data Management 
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Diagram DA1. OS/VS2 Catalog Management Table of Contents 


OS/VS2 catalog 


management 
overview 


Diagram DB! 


Search: Retrieve GENDSP: List the SUPERLOCATE: 
contents of a data List a data set's 


space volumes 


Diagram DF 1 Diagram DG1 


LOCATE: Retrieve 
catalog information 


Diagram DE] 


Check securit 
the base catalog > : 


record 


authorization 


Diagram DD] 


LOCATE based on Obtain a catalog 


a generic name 


Diagram DG5 


record field's 
value 


Diagram DL! 


Locate a 


generation data 
set's record 


UPDATE: Modify 


catalog information 


Diagram DH1 


UPDATE-Enxtend: 
Obtain additional 
space fora VSAM 
object 


Diagram D!1 


Suballocate: Obtain 
space froma 
nonunique VSAM 
data space 


Diagram DJ1 


LSPACE: Build 


an “available 
space” report 


| Diagram DKI DK1I 


Modify a 


catalog record 
field's value 


Diagram DM | 


REUSE: Reset 
a VSAM data 
set 


Diagram D13 
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Diagram DB1. OS/VS2 Catalog Management Overview 


VSAM Open, Close, and End-of- 
Volume, and Access Method 
Services issued CATLG (SVC 26) 
for an OS/VS2 Catalog Record. 


OS/VS2 catalog management 


OS/VS2 Catalog Management 1. If caller is not in supervisor state or key 0, validity- R15 
begins here. check the CTGPL. If check fails, issue WTO VILEEAL AY 
message IEC3381 and return to caller. 4: - 
RI 
2. Issue GETMAIN for CCA. If GETMAIN fails, issue y 
TOCTGPL Seals WTO message IEC3391 and return to caller. J22Z2LRL LL 
BE ’ ‘CA. CTGPL)~—sCTGF Ls 
CTGPL Pe 3. Establish a recovery environment. —< : 


Request type 


Cititagaecerd ie - 4. Build and initialize a CCA for the caller’s request. 
identifier > 


ace. ~~ 
— 
— 


‘4 


LA 
5. Initialize the caller’s CTGPL and CTGFLs. Z22222422"_ ALLL ELL ALD ALE EL 


eae \ 
tCTGFL Re 
CTGF ‘TGEL's ~ 
oy ee Ff 6. Retrieve the catalog record identified by the caller: 
~ 


=| 


(See Diagram DC], ‘“‘Search: Retrieve the Base 
S Catalog Record.’’) 


7. If the caller issued an Access Method Services 
command, process it and bypass steps 3 through 5. 
(See Diagram EB1, ‘‘Catalog Management Services 
Overview.”’) 


OS/VS2 catalog 


es 8. Check the caller’s authorization to use the record: 7 
{fs N (See Diagram DD1, “Check Security Authorization.’’) 


Authorized Not authorized 


OS/VS2 catalog record 
{from step 5) 


” 


>I. Determine the request type and process It: 


eA RTT SUPER- mi (See Diagram DG1, “SUPERLOCATE, 
sr al LOCATE Build a List of all Volumes Associated 


with a DSNAME.’’) 
GENDSP mi (See Diagram DF1, “GENDSP: Build a 


List of all Data Sets in a VSAM Data 
Space.”’) 


LOCATE mm (See Diagram DE], “LOCATE: Retrieve 
Catalog Information.’’) 


UPDATE> (See Diagram DH1, “UPDATE. Modify 
Catalog Information.’’) 


LSPACE mi (See Diagram DK1,“LSPACE: Build an 
‘Available Space’ Report.’’) 
10. Release virtual storage obtained for this request. 


11. Write problem determination message and set error 
code, if any. 


12. Release recovery environment. 


OS/VS catalog management 


CCACD1 


Register 15 


-——"> 13. Return to the caller. 


OS/VS2 catalog management buffer 


Catalog record 


ged 
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Notes for Diagram DB1 


Catalog Management is called when VSAM Open, Close, 
End of Volume, or the Access Method Services routines 
issue the CATLG macro instruction (SVC 26). Register 1 
contains the address of the caller’s catalog parameter list. 
The catalog parameter list identifies which catalog record 
to process and what process to perform. 


Catalog Management is also called when the user's 
program issues OS Catalog Management macro 
instructions: CAT, LOC, RECAT, and UNCAT. The 
user's program builds a CAMLST parameter list to 
describe the request. Register 1 points to the CAMLST. 


A user's program can access the OS/VS2 catalog by 
issuing an Access Method Services utility request. Access 
Method Services translates the request into an SVC 26 
and a catalog parameter list. 


IGC0002F 


Receives control from dummy catalog module 
IGG026DU. 


Register 1 contains the address of a catalog parameter 
list (CTGPL). OS/VS Catalog Management transfers 
control (XCTL) to OS/VS2 catalog management load 
module, IGGOCLAI1. 


IGGOCLAI calls IGGOCLC9 to process the VSAM 
catalog management request. 


1 IGGOCLC9: BLDCCA 


A call is made to the task supervisor validity-check 
routine to verify that the storage passed as a CTGPL is 
owned by the caller. A condition code of 8 is set in the 
PSW if the check is successful. 


2 IGGOCLC9: BLDCCA 


Issue a page boundary GETMAIN for CCA and 
record areas. If return code is not zero, issue message. 
Set return code 8 in register 15 if caller was a 
SUPERLOCATE request or a translated request. If it 
was not, set reason and error code and module ID in 
the CTGPL. 


3 IGGOCLCS: BLDCCA 
Issue ESTAE to establish recovery environment. 
4 IGGOCLC9: BLDCCA 


The catalog control area (CCA) contains data about 
catalog records retrieved to process the request. The 
CCA also contains a register save area that shows the 
flow of control between catalog management routines 
used to process the request. 


C 


Each time a catalog management routine calls another 
catalog management routine, the contents of registers 
12, 13, and 14 are put in the CCA’s register save area. 
Register 13 contains the address of the next 12-byte 
register save area in the CCA. Register 12 contains the 
address of the calling routine. Register 14 contains the 
return address to the calling routine. 


IGGOCLAB: IGGPACDV (calls IGGPSCNC 
(IGGOCLAY)) 


The caller’s work area and each CTGFL are checked 
to ensure that it is within the caller’s address space. 


The CTGFL’s field-name value is used to obtain 
dictionary data that defines the field’s characteristics 
and location within the record. 


IGGOCLAB: IGGPACDV (calls IGGPSCAT 
(IGGOCLAH)) 


The catalog record is identified by the caller's dsname 


value, volume serial number, or control interval 
number. 


IGGOCLAB: IGGPACDV (calls IGGPCDVR 
(IGGOCLAT)) 
An Access Method Services command is translated 


into a catalog management services request to create, 
modify, delete, or list catalog records. 


IGGOCLAB: IGGPACDV (calls IGGPCKAU 
(IGGOCLBM)) 


The caller's request type determines the level of 
authorization that allows the OS/VS2 catalog 
management routines to complete the caller’s request. 


IGGOCLAB: IGGPACDV (calls IGGPSLOC 
(IGGOCLAM), IGGPGDSP (IGGOCLBJ), IGGPLOC 
(IGGOCLAZ), IGGPUPD (IGGOCLAY), or IGGPLSP 
(IGGOCLBK)) 
IGGPSLOC: 
A SUPERLOCATE request builds a list of all 
volumes and units associated with a dsname. 
IGGPGDSP: 
A GENDSP request builds a list of all VSAM data 
sets in a VSAM data space. 
IGGPLOC: 


A LOCATE request retrieves information from the 
catalog record. 


Cc 


IGGPUPD: 


An UPDATE request modifies information in a 
catalog record. An UPDATE request can also 
obtain direct-access space for the data set or index 
identified by the dsname value. 


IGGPLSP: 
A LSPACE request determines the amount of 


available space on a direct-access volume, when the 


volume is described in a VSAM catalog. 
10 IGGOCLC9: IGGPRCU 


When the OS/VS2 catalog management request is 
complete, all virtual storage obtained for work areas, 
control blocks, and the request’s CCA is returned to 
the OS/VS system. 


11 IGGOCLC9: IGGPRCU 


Write problem determination message if it was a 
SUPERLOCATE request or a translated request and 
set error code in CTGPL. 


12 IGGOCLC9: IGGPRCU 
Issue ESTAE to remove recovery environment. 


13 OS/VS2 catalog management common processing 
(IGGOCLC9) sets a return code in register 2 and 
returns to IGGOCLAI. 


IGGOCLAI transfers control (via XCTL) to 
I1GG0102F, an entry point in IGCOO02F. If OS/VS2 
catalog management determines that CVOL 
processing is required, IGGOCLAI exits to 
IGGOCLCA—the OS/VS CVOL processor. 


IGC0002F puts the return code into register 15 and 
returns to the caller via the SVC return. 


For additional information about topics related to the 
OS/VS2 catalog management overview, see: 


“‘Data Areas:” 


Catalog communications area (CCA) format and 
description 

Catalog parameter list (CTGPL) format and 
description 

Field name dictionary 


“Diagnostic Aids:” 


CCA register save area 
Catalog management return codes 


For additional information on dummy catalog 
module, see OS/VS2 System Programming Library: 
Data Management 
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Diagram DC1. SEARCH: Retrieve the Base Catalog Record, Search the Caller-Specified Catalog 


CTGPL y BY $ x a 
Catalog ——_——-—— > 1. Did the caller identify a catalog to search? 
identifier Yes No 
DC2 
: Step 10 


Locate the caller-specified catalog 


When the catalog identifier points to a catalog’s ACB: CCA 


2. Put the catalog’s ACB address into the CCA. eee 
3. Search the catalog for the caller’s information. 
(See Steps 25—32.) Is it found? 
See “Open Catalog Yes No 
Control Blocks” 
Ls Return on error to the caller. Buffer 
PCCBs Object’s base 
Return to the caller. catalog record 


When the catalog identifier points to a catalog’s DSNAME: 


—> 4. Examine each PCCB for a matching DSNAME. 
Is it found? | 
No Yes 


DC2 
step 8 


5. Search the master catalog for a user-catalog 
catalog record with the catalog’s DSNAME. 
Is it found? 

Yes No 


SO Return on error to the caller. 


6. Is the catalog’s DSNAME an alias? 
No Yes 


Master 
catalog 


(a) —— ¥ 7. Determine the true name of the user’s 
catalog and examine each PCCB fora 
matching DSNAME. Is it found? 


Yes No 
DC2 
step 9 


Cy uonesadg jo pouap 
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Notes for Diagram DC1 


1 


| 2 


IGGOCLAH: IGGPSCAT calls IGGPSC2 (IGGOCLAH) 


The CTGPL's catalog identifier field, set by the caller, 
can contain the address of a catalog’s ACB, the 
address of a catalogs DSNAME, or 0. 


IGGOCLAH: IGGPSC2 


The catalog specified by the caller is the only catalog 
searched. The Catalog Management Services DEFINE 
routine calls the Search routine to confirm that, when 
a caller wants to create a VSAM cluster or catalog, the 
new cluster or catalog DSNAME isn’t duplicated in 
the catalog. The caller (Catalog Management Services 
DEFINE routine) expects the “no record found” 
return code. 


IGGOCLAH: IGGPSC2 calls IGGPDOG (IGGOCLA3) 
IGGOCLAH: IGGPPCCP calls IGGPGPCC (IGGOCLA3) 


If the CTGPL’s catalog identifier field contains the 
address of a catalog DSNAME, the search routine 
examines each protected catalog control block (PCCB) 
for a matching DSNAME field. Each PCCB contains 
the address of its catalog’s ACB. 


If no PCCB contains a matching DSNAME, the 
user-supplied catalog DSNAME refers to either a 
nonexistent catalog or to an unopened catalog. 


IGGOCLAH: IGGPPCCP calls IGGPDOG (IGGOCLA3) 


The AMCBS (addressed by the CVT) contains the 
address of the VSAM master catalog’s ACB. 


IGGOCLAH: IGGPPCCP 
IGGOCLA3: IGGPDOG calls IGGPGRE 
IGGOCLAH: IGGPPCCP calls IGGPGPCC (IGGOCLA3) 


CC 


For additional information about topics related to 
Search processing, see: 


‘“‘Data Areas:” 


Cluster catalog record description 

Volume catalog record description 

Access method control block (ACB) format and 
description 

Catalog communications area (CCA) format and 
description 

Catalog parameter list (CTGPL) format and 
description 

CTGPL search options 

Private catalog control block (PCCB) format and 
description 

Access method control block structure (AMCBS) 
format and description 


Open Catalog Control Blocks 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram DC2. SEARCH: Retrieve the Base Catalog'Record, Search All Catalogs Available to the Caller 


DC 1 


| PCCB step 4,6, Locate the caller-specified catalog (continued) 


See “Open Catalog 
Control Blocks” 


Open bit > 
-_-—-—-—-- > 8. Is the user’s catalog open? 
No Yes 
9. Open the user’s catalog. 


See Diagram BB1—Opening A User’s Catalog 


sen Search the JOBCAT or STEPCAT catalogs 


Dynamically 
opened user’s 
catalog 


ICL statements 


JOBCAT = DSNAME 


— — —-—}7 10. Did the user’s JCL parameters include a JOBCAT 
or STEPCAT? 


STEPCAT = DSNAME 


No Yes 
Buffer 
User’s > 11. Search each user-specified JOBCAT and Object’s base 
catalogs STEPCAT catalog for the caller’s catalog record 


information. (See steps 25—372.) 
Is it found? 


a: 
ae 
No Yes 
; Cu» Return to thecaller. Zaza 


CTGPL Search the master catalog 


Catalog [os 
identifier 
13. Search ti:e master catalog for the caller's 
—— on 1 information. (See steps 25 —32.) Is it 
found? 


Master No Yes 


catalog 
| Rem Return to the _ 


. Return on error to the caller. 


t Buffer 


Return 
code 


\ 
\ 


12. Is the data set’s DSNAME in the form ‘“A.B’’? 
Yes No 


PULALERREREESRSRERRESRERERSSERAREREDLD! 
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Notes for Diagram DC2 

8 IGGOCLAH: IGGPPCCP 

9 IGGOCLAH: IGGPPCCP calls IGGPACI 

10 IGGOCLAH: IGGPS(C2 calls IGGPCSCP (IGGOCLA3) 


If the CTGPL’s catalog identifier field contains 0, the 
user catalogs specified by the user's JCL JOBCAT and 
STEPCAT DD statements, and the master catalog, are 
searched until either the record is found or there are 
no more catalogs to search. 


The JSCB contains the address of the first PCCB in 
the PCCB chain. Each PCCB describes one of the user 
catalogs that have been opened to satisfy the user’s 
JCL JOBCAT and STEPCAT DD statements. A 
PCCB contains the address of a catalog’s ACB. The 
catalog’s ACB address is put in the CCA to identify 
the catalog being searched. 


11 IGGOCLA3: IGGPCSCP calls IGGPDOG 
12 IGGOCLA3: IGGPCSCP 
13 IGGOCLA3: IGGPCSCP calls IGGPDOG 
14 IGGOCLA3: IGGPCSCP 


Cc 


For additional information about topics related to 
Search processing, see: 


‘“‘Data Areas:” 


Cluster catalog record description 

Volume catalog record description 

Access method control block (ACB) format and 
description 

Catalog communications area (CCA) format and 
description 

Catalog parameter list (CTGPL) format and 
description 

CTGPL search options 

Private catalog control block (PCCB) format and 
description 

Access method control block structure (AMCBS) 
format and description 


Open Catalog Control Blocks 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DC3. SEARCH: Retrieve the Base Catalog Record, Search the Catalog Identified by a Qualified Name 


ne 14 15. Examine each PCCB for a DSNAME that matches 
PCCBs c No “A”. Is it found? 


Yes > (2!) t Buffer 


is on Return 
} 16. Search the master catalog for a catalog record -” 


(B) with DSNAME “A,B”, (See steps 25— 32.) > 
z - 
ee ae Is it found? eee ¢ Buffer 


Master No Yes > Return to the caller. S Obmece base 
catalog ¥ catalog records 
Search the user’s catalog identified by DSNAME or Oza 
qualified (alias) name ‘“‘A”’ OR 
17. Search the master catalog for a user-catalog or Buffer 
alias catalog record with DSNAME “‘A’’, (See User-catalog or 
steps 25—32.) Is it found? alias-name catalog 
Yes No 5S record 


: 18. Return on error to the caller. / 
Alias catalog record 


[ewan [osx] }--~— 


19. Is ‘‘A’’ an alias? 
No Yes 


User’s-catalog catalog record — > 20. Determine the true name of the user’s 


catalog and examine each PCCB fora 
TY matching DSNAME. Is it found? 
as 


Control Blocks”’ 


21. Is the user’s catalog open? 
Yes ¥ 


4 Open the user’s catalog. ete 
catalog 
See 5: peeueameeae BB1—Opening A User’s 
es L esaogh PPI Opening Yes £ 
User’s 
catalog "with DSNAME “‘A.B’’. (See steps 25-32). 


Is it found? 


Yes % () 
| 24. Return on error to the ellen / 
Return to the caller. 
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Notes for Diagram DC3 

15 IGGOCLA3: IGGPCSCP calls IGGPCPCC 
16 IGGOCLA3: IGGPCSCP calls |IGGPDOG 
17 IGGOCLA3: IGGPCSCP calls IGGPDOG 
18 IGGOCLA3: IGGPCSCP 

19 IGGOCLA3: IGGPDOG 

20 IGGOCLA3: IGGPDOG calls IGGPGRE 


If the PCCB identifies a CVOL-type catalog, 
IGGPDOG initializes the controller's work area for 
CVOL processing and exits to IGGOCLCA—the 
OS/VS CVOL processor. 


21 IGGOCLA3: IGGPCSCP 
22 IGGOCLA3: IGGPCSCP calls IGGPCSDO (IGGOCLAH) 
23 IGGOCLA3: IGGPDOG 
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Diagram DC4. SEARCH: Retrieve the Base Catalog Record, Retrieve the Caller-Specified Record 


SARI 


Register 11 CTGPL 
fCCA identifier 
CCA 
Request 
options ~ 
™~ 
~ 
™ 
~ 
SS 26 
Catalog 
EE a 
Catalog Index record 28 
records 
Yes 


Catalog 
true-name 
records 


Data 
High-key range 


True-name record 


DSNAME CIi# 


Low-key range 


Catalog 
data 
records 


Object’s base 
record 


. Search the catalog’s index and true-name 


. Read the catalog record from the OS/VS2 catalog 


Search a catalog to retrieve the caller-specified record 


Catalog record --————"' 25. The catalog record identifier addresses either: 


e A data set’s DSNAME or a volume’s serial 
number 


Or 


e A catalog record’s control interval number 


RPL 
Nee (53) PY Request 
options 


. Allocate and initialize an RPL for the catalog a veatee 
being searched. 


Put the catalog’s ACB address into the RPL. a= 


TRPL 

records to find the catalog record’s control pee 
Return 
code 


interval number. Is it found? 
No 


29. Set an error code and return. t Buffer 


Buffer 


. Is the DSNAME an alias? 


Yes Alias catalog 
\ record 


31. Obtain the control interval number of the 


object’s catalog record. ok 


Buffer 


into a catalog management buffer. 


re | 


Object’s base 
catalog record 
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Notes for Diagram DC4 
25 IGGOCLA3: IGGPDOG For additional information about topics related to 


26 IGGOCLA3: IGGPRPLF and IGGPRPLM Search processing, see: 


The search routine assigns one request parameter list Data Areas: 

(RPL) to the caller. Catalog management routines Catalog record general format and description 
issue GET and PUT macro instructions to retrieve and Catalog communications area (CCA) format and 
write catalog records. Each record-management description 

request (GET, PUT, etc.) needed to satisfy the caller’s “Diagnostic Aids:” 


catalog-management request refers to this RPL. This 
RPL is initialized for a caller and used as often as Catalog management return codes 
necessary to process the caller’s catalog-management 

request. When the caller's catalog-management 

request is completed, the RPL is assigned to another 

caller. 


27 IGGOCLA3: IGGPGPCC 
28 IGGOCLA3: IGGPDOG 


The goal of the search is to find the true-name record 
identified by the DSNAME or the volume serial 
number. The true-name record contains the DSNAME 
or volume serial number and the control interval 
number of the cluster, data, index, nonVSAM, alias, 
GDG base, or volume catalog record. 


29 IGGOCLA3: IGGPDOG 
30 IGGOCLA3: IGGPDOG 
31 IGGOCLA3: IGGPDOG calls IGGPGRE 
32 IGGOCLA3: IGGPDOG 


The catalog record is located by its control interval 
number and read into a catalog management buffer. 
The buffer’s address is put into the CCA. 
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Diagram DD1. Check Security Authorization 


Virtual Storage for the Caller’s Program Verify the caller’s authority to bypass security checking 
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‘1. Does the caller want to bypass security checking? 


= CTGPL 
tCCA No Yes 


Request _ 
oon Option -_—o-7 


Password |» _-7 


TCTGPI ae 2s 2. Is the caller in cither protection key 
PL ecking SRR CAe Shae! 
= Options \ QO or supervisor state 
Catalog \ et Yes Ri 
Record User- \ ” 
Supplied wo 
tACB Password -71\ 
Caller’s N\ 
Identity \ 
Catalog Management Buffer OK Return Error Return 
Catalog Record \ 


(Retrieved by the Caller) 


Header A) 
RACE 2 
Indicator 


Password 
Set of Fields 


Code Word 


\ 
(), Check the user-supplied password 
NV 


\P™ 3. Determine the type of security to be checked. 


EY : : 
4. Obtain the password trom the catalog record. 


(See Diagram DLI. “Obtain a Catalog Record Field's 
Value.) 
5. Is user authorized through any RACF-indicated 


Number of source? 
Attempts No Yes 


: 6. Are there any non-RACF sources through which 
~ACB authorization can be obtained? 
tCAXWA | 
ase 
ofA) 7. Is there a user-supplhied password? 
CAXWA an | Yes Np Console or 
RACF Indicator | | TSO ‘Terminal 
for Containing | MA, 
Catalog | 8. Request the password. 
tCatalog’s : ee . es 
RACE Profile Supply Correct | ype| 
| Password for {| Codeword | 
| Data Set" 
) 9. Does the password in the catalog record equal the 
| user-supplied password? 
| Yes No 
Operator | $ 
Reply L 


—§-10. Did the user exhaust the number of attempts 
he has to supply the password” 
Yes No 


WONG 


Error Return 
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Notes on Diagram DD1 


IDA0192C and IGGOCLAB: IGGPACDV (calls 
IGGPCKAU (IGGOCLBM)) 


When the VSAM Open routine (IDA0192C) calls 
OS/VS2 Catalog Management to retrieve a cluster 
catalog record, the security checking routine confirms 
the user's authorization to gain access to the cluster. 
See VSAM Open Processing, in OS/VS2 Virtual 
Storage Access Method (VSAM) Logic, for details 
about connecting a data set to a user’s program (open 
processing). 


IGGOCLAT: IGGPCDVR (calls IGGPCKAU 
(IGGOCLBM)) 


When an Access Method Services routine calls a 
catalog management services routine, the security 
checking routine confirms the user’s authorization to 
gain access to the catalog or to a specific catalog 
record. 


The catalog record containing the password(s) is 
available in the buffer addressed by the caller's CCA. 


The RACF indicator is contained in the catalog record 
for VSAM data sets. If an entity is protected by RACF 
and passwords, only RACF authorization will be 
checked. In some cases, the source of authorization to 
an item may be obtained either from the item itself or 
from another source. For example, one can export a 
cluster by having an authorization to the cluster or to 
the catalog that contains the cluster. 


The type of processing that the user is allowed to do 
with the data set is determined by the password or 
RACF authorization. The levels of authorization are: 


e RACF alter authorization or master password: The 
user is allowed to modify passwords and catalog 
records that describe his data set, and to process 
his data set’s control intervals and records. 


e RACF control authorization or control-interval 
password: The user is allowed to process the data 
set’s control intervals as wells as its records. 


¢ RACF update authorization or update password: 
The user is allowed to process his data set’s 
records. 


¢ RACF read authorization or read-only password: 
The user is allowed to read, but not to write (add or 
update), records in his data set. 


IGGOCLBM: IGGPCKAU 


If the user’s security has been verified during a 


9 


Cc 


previous catalog management request, the caller 
(VSAM Open) can set the CTGPL’s 
bypass-security-checking flag on. 


IGGOCLBM: IGGPCKAU 


Other catalog management callers, such as the user’s 
program (with Access Method Services commands), 
and utility programs, are not in protection key 0 or 
supervisor state. If these programs attempt to bypass 
security checking, the security checking routine sets an 
error return code that prevents further catalog 
management processing for the caller's program. 


IGGOCLB6: IGGPSPSC 


Check for special situations and determine what levels 
of security need to be verified and on which entity 
security verification is to occur. Check, also, for cases 
in which no verification is required. 


IGGOCLBM: IGGPCKEX 


The password is in the password set of fields in the 
cluster, data, or index catalog record. The CTGPL can 
contain a password that the user supplied in a JCL 
Statement. 


IGGOCLBM: IGGPPWVR (calls IGGPRACV 
(IGGOCLDC)) 


If a source through which one may obtain 
authorization is RACF-protected, IGGPRACYV is 
called to check for RACF authorization. If RACF 
authorization to the entity cannot be obtained through 
the RACF sources, then password checking is 
performed on the non-RACF sources. 


IGGOCLBM: IGGPPWGT 


The console operator, or TSO user, can reply to the 
VSAM request-for-password message with a password. 


IGGOCLBM: IGGPPWVR 


10 IGGOCLBM: IGGPPWVR 


For additional information about topics related to 
password checking processing, see: 


“Data Areas:” 
Password set of fields description 
‘“Introduction:” 


Passwords 
Password processing restrictions 
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Diagram DD2. Check Security Authorization 


Virtual storage for the caller's program Ree, 


Call the user security verification routine (USVR) 


Ril 
11. Does the caller have master password or RACF 
, alter authorization to the entry? 
CTGPL 7 Yes No 
CCA ge $ 
: Pa 
Security Pa 
checking 12. Is there a USVR specified for the user? 
options Virtual storage 
mos es for the user's address space 
record ¥ 
User security 
13. Call the USVR to confirm the user verification 
Catalog management buffer program’s authorization to process routine (USVR) 
the data set’s records. 
Catalog record 
(retrieved by the caller) 
Password 
set of fields 14. Is the USVR return code 0? 
S A Yes No 
a 
Error Return — 
a 
a” 
a” 
“ 
7 Return to the caller 


R15 (Set by USVR) ~~ 
15. Set a return code-—successful completion—and 
Berar code return to the caller. 


CCAPROB 


16. Set an error return code—security verification 
error—and return to the caller. 
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Notes for Diagram DD2 
11 IGGOCLBE6: IGGPINMD 


If the user supplied the correct master password or has 
RACF alter authorization, the user security 
verification routine (USVR), if it exists, is bypassed. If 
a USVR exists, the USVR exit is taken only if the user 
provided another type of password correctly. 


12 IGGOCLB6: IGGPINMD 


If a user security verification routine exists, its name is 
in the catalog record’s password set of fields. 


13 IGGOCLB6: IGGPINMD 


The user security verification routine (USVR) is an 
installation-supplied routine that confirms a user’s 
authorization to gain access to the data set. The USVR 
confirms that the user satisfies the installation’s 
security verification criteria. 


C 


For additional information about topics related to 
security checking processing, see: 


‘‘Data Areas:” 


Cluster catalog record description 
Password set of fields description 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DE1. LOCATE: Retrieve Catalog Information 
y 


1. Obtain information about each CTGFL’s field 
name. 


Virtual Storage for the Caller’s Program 


2. Do steps 3 through 16 for each of the caller’s 


Ril 


“ No Yes 

“ | 

4. Use the associations in the current entry to 
read the upgrade entry into the catalog 


management buffer. 


. Is the field to be retrieved only if caller-specified 
test conditions are satisfied? 


tCTGPL 
CTGFL 
*Current 
CTGFL 


CTGFL for Tests 


Field Name 
Test-Data Area 
Address snd Length 


of Test Data 


tNext CTGFL for Tests 


Catalog Management Buffer 
Object’s Catalog Record 


CCA 


Ss 


Sequence 
Number of 
Each Set of 


No Yes 


Fields that 


Satis fies 
the Tests 
CTGFL 
“Test Failed” 


6. Identify each set of fields that satisfies the 
test conditions. 


7. Does at least one set of fields satisfy the test 


Set-of | \_ Set of Fields conditions. TITTTATILL 
# Fields Field to Field to 
Retrieved Pested ca a Catalog Management Buffer 


Pointer 
| oT 


CTGFLs. 
— 3. Is the field to be retrieved an upgrade field name? Virtual Storage for the Caller’s Program 
tBuffer ge 


CTGPL 


Object’s Catalog Record 


Fields 
Pointer 


Set of Fields 


Field to Field to 
be be 
Retrieved | Tested 


C C C 


Notes for Diagram DE1 7 


IDA0192C 3 IGGOCLAZ: IGGPSCNF (calls IGGPUPGD) The sequence number of each set of fields that satisfies 


Lg uotyeisdg jo pomp 


The VSAM Open routine issues the CATLG macro 
instruction (SVC 26) to obtain data set and volume 
information about the user’s data set and index. See 
VSAM Open Processing, in OS/VS2 VSAM Logic, for 
details. 


IDAQS557A 


The VSAM end of volume routine issues the CATLG 
macro instruction (SVC 26) to obtain volume 
information about the extents added to the user's data 
set. See VSAM End-of-Volume Processing, in 
OS/VS2 VSAM Logic, for details. 


IGGOCLAB: IGGPACDV (calls IGGPLOC 
(IGGOCLAZ)) 


When the caller issues a CATLG macro instruction, 
register 1 points to the caller's catalog parameter list 
(CTGPL). The CTGPL’s request options are decoded 
and the base catalog record is retrieved for the 
request. See Diagram DB1, OS/VS2 Catalog 
Management Overview, for details about initial 
catalog management processing and request decoding. 


IGGOCLB7: IGGPRUS, IGGPFRWK (calls IGGPLOC 
(IGGOCLAZ)) 


Upon completion of Reuse processing, LOCATE is 
called to return catalog field information from the 
reset entry. 


IGGOCLAZ: IGGPEXT (calls IGGPSCNC (IGGOCLAY)) 


Each CTGFL is initialized with the dictionary entry 
associated with the CTGFL’s field-name value. Calls 
from within catalog management (as opposed to 
external calls, such as LOCATE) enter at this point to 
use the field management retrieval function. 


IGGOCLAZ: IGGPSCNF 


Steps 3 through 16 are performed for each of the 
caller's CTGFLs. 


The Locate routine processes each CTGFL associated 
with the caller's CTGPL and returns as much 
caller-requested data (in the caller’s work area) as the 
caller's test conditions and work area size permit. 


A caller may request catalog information from an 
associated upgrade entry by using upgrade field 
names. 


IGGOCLAZ: IGGPUPGD 


The upgrade entry may not be in the catalog 
management buffer. If it is not in the buffer, the 
associations in the current entry are used to retrieve 
the upgrade entry. 


IGGOCLAZ: IGGPSCNF 


The caller's CTGFL list contains the address of each 
CTGEFEL required to satisfy the caller's need for catalog 
information. Each CTGFL describes one of the 
catalog record fields to be retrieved. Each CTGFL is 
completely processed before the next one is started. 


IGGOCLAZ: IGGPSCNF (calls IGGPTSTS 
(IGGOCLBA)) 


A caller might make conditional requests for retrieval 
of catalog record fields. For example, a chain of 
CTGFLs might be supplied with the request and 
processed together. The first CTGFL identifies a field 
to be retrieved and points to subsequent CTGFLs that 
contain the names of catalog fields to be tested, the 
test conditions (equal, low, high, etc.), and the address 
and length of the caller’s test data area. The catalog 
record fields identified by the second and subsequent 
CTGFLs are compared to (or tested against) the 
caller’s data. If the comparison satisfies the test 
conditions, the catalog record field specified by the 
first CTGFL is retrieved. 


IGGOCLBA: IGGPTSTS 


If the caller wants to retrieve a catalog record’s header 
field, the field’s data is retrieved if all tests are 
satisfied. 


If the caller wants to retrieve a field from one of the 
sets of fields that follow the header fields, the field’s 
data is retrieved from each set of fields that satisfies all 
tests. 


the tests is put in the CCA. After the sets of fields have 
been tested, the sequence numbers in the CCA are 
used to identify each set of fields that contain 
caller-requested data. 


For additional information about topics related to 
LOCATE processing, see: 


‘‘Data Areas:” 


Catalog record description and format 
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Diagram DE2. LOCATE: Retrieve Catalog Information 


Virtual storage for the caller’s program ery Virtual storage for the caller’s program 
Rll CTGPL 
tCCA ox 
[tcca Po a’. Is more than one field identified by the field 
/ name (a combination field name)? 
/ No Yes 


7 tCTGFL | / ¥ 
y, / 9. Do steps 10 through 15 for each field Eas 


tCurrent ; . ; . 
CTGFL 7 CTGFL associated with the combination name. Rea GEE 
Field = 
ae o> 10. Does the caller want the address of the catalog’s ACB? {Buffer 


N“ 
tCatalog’s Yes N 
pe Ti 


‘“ Field name (combination) 


tCTGFL 


“A111. Get the field’s value from the catalog record. 
(See Diagram DL1, ‘‘Obtain A Catalog Record 


Work eres Field’s Value.”) 
1 h in th bination 
ae, ne Put the field’s data in the caller’s work area ee re 
Current total = a1? “ Address and length of 
length SS 12. ae a data field’s length to the “current total eae at aces 
~ Om 
Peri ™ LIN Combination 
re 413. Is the ‘‘current total length’ greater than the work name index 
area length? Work area 
length 


14. Move the field’s data into the work area. 


Catalog management buffer 


15. Put the data’s length and address 
into the CTGFL. 


Object’s catalog record 


ye Set of fields 


eg to Other 
. fields 
retrieved | "© 


“f 


16. If the upgrade entry was read in to process an 
upgrade field name, restore the original entry. 


17. Perform final derived volume entry field 
processing. 


18 Return to the caller when all CTGFLs have been 
processed. 


y CCAPROB 


c c 


t Field name in the 


combination name index 


be 
retrieved 


Catalog management buffer 
Object’s catalog record 
_ Field to 


Catalog 
field’s 
data 


C 


Notes for Diagram DE2 
8 IGGOCLAZ: IGGPLOC2 


A combination name refers to a set of related catalog 
field names, and is used by the caller instead of a 
separate CTGFL for each field name. 


IGGOCLAZ: IGGPLOC2 


cr 


15 IGGOCLAZ: IGGPSHIN 


The CTGFL’s field-data entry contains the beginning 
address and length of the data in the caller's work 
area. When control is returned to the caller, the caller 
can use the field-data entry to locate a specific field’s 
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data in the work area. 
16 IGGOCLAZ: IGGPSCNF 


If the field name processed required the upgrade entry 
to be read in, the original entry is restored before the 
next CTGFL is processed. 


17 IGGOCLAZ: IGGPEXT 


If this function was requested by an internal catalog 
management function, final derived volume 
processing must be done. This processing consists of 
generating certain volume entry fields from the 
catalog information returned in the user’s work area. 


18 IGGOCLAZ: IGGPLOC 


The combination name index has an entry for each 
field name in the combination. The Locate routine 
processes each field name entry in the combination 
name index sequentially, starting at the index of the 
first field name entry for the combination, and ending 
when the number of entries processed equals the 
number of field names associated with the 
combination name. 


The test sequence (if any) associated with a 
combination-name CTGFL is done only once, not 
once for each field name in the combination. 


10 IGGOCLAZ: IGGPLOC2 


The address of the catalog’s ACB is in the CCA. All 
other catalog record fields that the caller can request 
are in the catalog record. Each catalog record field is 
identified by its field name. 


11 IGGOCLAZ: IGGPLOC2 (calls IGGPGVAL 
(IGGOCLBA)) 


For additional information about topics related to 
LOCATE processing, see: 


‘‘Data Areas:” 


Catalog parameter list (CTGPL) description and 


; wal oe format 
Diagram DL1, Obtain A Catalog Record Field's Field parameter list (CTGFL) description and 
Value, shows how the requested catalog record field format 
(specified by its field name in the CTGFL) is located Catalog communications area (CCA) description 
for the Locate routine. and format 


12 IGGOCLAZ: IGGPSHIN Catalog record field names and descriptions 


The first two fields in the caller's work area specify the 
number of bytes the caller allocated to the work area 
and the number of bytes that contain catalog record 
field data (the ‘‘current total length” field). If the 
“‘current total length” exceeds the work area length, 
the current total length field is updated with the length 
of the catalog record data, but the data itself is not 
moved in the caller’s work area. 


14 IGGOCLAZ: IGGPSHIN 


The Locate routine puts the beginning address and the 
length of the catalog field into the CTGFL’s field-data 
entry. 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DF1. GENDSP: List the Contents of a Data Space 


Virtual storage for the caller’s program 
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1. Is data space unique? 


wy List all VSAM objects 
% in a data space 


No. Y 
y Get the true-name record. \ 
3. Put volume ACB address, CI number, and 
length of CI in user’s area. CCAPROB 
4. Return to caller sxsxf>| Return code [Return code | 


_|_N 


. Retrieve the data space group set of fields associated 
with the data space. 


Do steps 6 through 8 to examine each Data Set Directory 
entry in the volume catalog record. 


Virtual storage for the caller’s program 


CCA 
tCTGPL 


CTGWKA 


[_—<<_—$<—<$<—<__ 7 6. Retrieve the Data Set Directory entry. 


CTGPL 


7. Does the Data Set Directory entry indicate that its 
A = VSAM object is allocated an extent in the data 
space? 


No Yes 


(By —— > 8. Put the control interval number of the 
‘ VSAM object’s catalog record into the list. 


3-byte control 
interval number 
of each VSAM 
object in the 
data space 


9. Return to the caller when all Data Set Directory 
entries have been processed. ESSETND) 


CCAPROB 
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Notes for Diagram DF1 


The caller (an OS/VS Utilities program or OS/VS Open) 


specifies the GENDSP option of LOCATE to obtain the 
control interval number of the catalog record of each 
object (cluster, data set, index, and catalog, etc.) that is 


contained in a VSAM data space. The caller identifies the 


data space with its volume serial number and data space 
name (from the format-1 (identifier) DSCB). 


1 


IGGOCLBJ: IGGPGDSP 


The user-provided work area is tested to ensure that 
the minimum size has been provided. The GENDSP 
routine tests the first seven characters of the data 
space name to determine whether the data space is 
unique. A data space name beginning with 
“*Z999999...”” is a nonunique data space. 


IGGOCLBJ: IGGPGUDS 


The true-name catalog record associates the data 
space name with the control interval number of the 
catalog record that describes the data space. 


IGGOCLBJ: IGGPGUDS 


The fixed length of the control interval number area 
and the control interval number are put into the 
user-provided work area. 


IGGOCLBJ: IGGPGDSP 


The CCA, a CPL, and two FPLs are set up to extract 
the data space group set of fields for the appropriate 
data space. The DSCB timestamp value is calculated 
from the data space name and used as the test value. 


IGGOCLBJ: IGGPGDSP 


Three FPLs are set up and the Data Set Directory 
entry is extracted. 


IGGOCLBJ: IGGPGDSP 


Scan the Data Set Directory set of fields to find a data 


space sequence number match. 
IGGOCLBJ: IGGPGDSP 


When a sequence number match is found, the volume 
ACB address, the length of the control interval 
number area, and the control interval number are put 
into the caller's work area. 


‘a 


For additional information about topics related to 
GENDSP processing, see: 


“Data Areas:” 


Volume catalog record description and format 
Fields derived from information in the volume 
catalog record 

Volume catalog record sets of fields’ descriptions 
and formats 


**Diagnostic Aids:” 


Catalog management return codes 
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Diagram DG1. SUPERLOCATE: List a Data Set’s Volumes 
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(see Diagram DGS). 

3. LOCATE-GDG: Build a generation 


data set’s DSNAME that includes the 
data set’s original DSNAME plus an 
absolute generation and version 
number (see Diagram DG6). 
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nonVSAM, alternate index, path, or user 
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Notes for Diagram DG1 


The caller (the OS/VS Scheduler) specifies the 
SUPERLOCATE option of LOCATE to obtain a list of 
volume serial numbers and device types for a data set’s 
volumes. The caller identifies the data set with its dsname 


value. 


When the caller specifies LOCATE-by-generic-name, 

| IGGOCLAM calls IGGPGLOC (IGGOCLAZ) to process 
the request. (See Diagram DGS for 
LOCATE-by-generic-name processing details.) When the 
caller specifies a relative DSNAME (in the form 
““dsname(n)’’), IGGOCLAM calls [|GGPGDGL 

| (IGGOCLAZ) to convert the relative DSNAME to an 
absolute DSNAME (in the form ‘‘dsname.GxxxxVyy ’’) 
and locate the catalog record identified by the absolute 
DSNAME. (See Diagram DG6 for 
LOCATE-GDG-data-set processing details.) 


1 IGGOCLAM: IGGPSLOC 
4 IGGOCLAM: IGGPSLIN and IGGPDBYC 
5.1IGGOCLAM: IGGPSLIN 
6 IGGOCLAM: IGGPSLIN 


The CTGPL’s ‘catalog record identifier” points to the 
object’s dsname value in the caller’s work area. The 
object might be a catalog, a VSAM data set, a 
nonVSAM data set, or a key-sequenced data set’s 
index. 


8 IGGOCLAM: IGGPSLOC 
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Diagram DG2. SUPERLOCATE: List a Data Set’s Volumes 
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Notes for Diagram DG2 
10 IGGOCLAA: IGGPSLEN and IGGPSLIV 
12 IGGOCLAA: IGGPSLEN 
13 IGGOCLAA: IGGPSLCG 


If the VSAM object is a base cluster data record, call 
IGGPSLY (IGGOCLAA) to obtain upgrade 
associations, if any. 


14 IGGOCLAM: IGGPSLEL 
15 IGGOCLAA: IGGPSLIV 


The volume list pointed to by CTGWAVL has the 
following format: 


The volume list contains no duplicate volume serial 
numbers. 


The volumes are divided by whether they are 
within the minimum unit count or outside it. 
Minimum unit count is the minimum number of 
direct-access devices required to mount the object’s 
volumes. Volumes must be contiguous by device 
type. Device types within the minimum unit count 
are not ordered in any particular sequence nor are 
they related to the device types outside the count. 


Volumes within the minimum unit count will each 
be assigned an individual unit by the Scheduler. If 
volumes that do not have units already assigned 
exist outside the minimum unit count, the last unit 
assigned to a volume of the same device type 
within the minimum unit count will be made 
nonsharable. If this is not possible, an additional 
nonsharable unit will be assigned. 


The volume list pointed to by CTGWAVL has the 
following content: 


All volumes in a given entry are placed into the 
volume list, regardless of whether they have 
allocated space. 


The volume information returned varies according 
to the entry type specified by the SUPERLOCATE 
request and whether the volume is within the 
minimum unit count or outside it, as follows: 


Entry Types C, D, G, I, and R 


Within the minimum unit count, the CRA volume 
for the particular entry is returned. 


Cc 


Data Entry (D): 


Within the minimum unit count, every volume in 
the upgrade set is returned. Each volume in the 
data entry that has a unique device type within the 
data entry and is either the first with allocated 
space (prime or overflow) or, if no volumes have 
allocated space, is the first candidate volume 
returned. 


Outside the minimum unit count, all others in the 
data entry are returned. 


Index Entry (I): 


Within the minimum unit count, each volume in 
the index entry that has a unique device type within 
the index entry and also is either the first with 
allocated space (prime or overflow) or, if there are 
no volumes with allocated space, is the first 
candidate volume returned. If sequence set is with 
data, the same volume may appear as both a prime 
and a candidate volume. 


Outside the minimum unit count, all others in the 
index entry are returned. 


NonVSAM Entry (A): 


Within the minimum unit count, each volume in 
the nonVSAM entry that has a unique device type 
within the nonVSAM entry is returned. For single 
volume entries, the TTR DSCB pointer is also 
returned. Every nonVSAM volume occurrence is 
marked as prime. Outside the minimum unit count, 
all others in the nonVSAM entry are returned. 


User Catalog Entry (U): 


Within the minimum unit count, each volume in 
the user catalog entry that has a unique device type 
within the entry is returned. Every user catalog 
volume occurrence is marked as prime. 


Outside the minimum unit count, all others in the 
user catalog entry are returned. 


Base Cluster Entry (C): 


Within the minimum unit count, every volume that 
does not have sequence set with data is returned. 
Otherwise, same as data entry. 


Outside the minimum unit count, all others in the 
data entry are returned. 


C 


Alternate Index Entry (G): 


Same as the base cluster entry, except that there is 
never an upgrade set. 


Alias Path Entry (R): 


Same as the base cluster entry, except that upgrade 
set inclusion depends on the 
UPDATE/NOUPDATE flag in the path entry. 


Normal Path Entry (R): 


Within the minimum unit count, every volume of 
the alternate index under this path is returned. 
Otherwise, same as the base cluster entry, except 
that upgrade set inclusion depends on the 
UPDATE/NOUPDATE flag in the path entry. 


Outside the minimum unit count, all others in the 
data entry are returned. 
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Diagram DG3. SUPERLOCATE: List a Data Set’s Volumes 
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Notes for Diagram DG3 

16 IGGOCLAA: IGGPSLR, IGGPSLIV, and IGGPSLY 
For each record obtained, IGGPSLEL extracts the 
volume information associated with the record. Then 
IGGPSLIV inserts the information into the caller’s 
work area. When the base cluster data record has been 


retrieved, IGGPSLY obtains any upgrade associations 
related to the record. 


17 IGGOCLAA: IGGPSLIV 
IGGOCLAM: IGGPSLEL 


IGGPSLIV inserts volume information into the caller’s 
work area. 


18 IGGOCLAA: IGGPSLY and IGGPSLIV 
IGGOCLAM: IGGPSLEL 


IGGPSLEL obtains the volume occurrences; 
IGGPSLIV inserts the volume information into the 
caller's work area. 


19 IGGOCLAA: IGGPSLEN 


If the VSAM object is a base cluster data record, call 
IGGPSLY (IGGOCLAA) to obtain upgrade 
associations, if any. 
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Diagram DG4. SUPERLOCATE: List a Data Set’s Volumes 
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Notes for Diagram DG4 
20 IGGOCLAA: IGGPSLEN and IGGPSLIV 


21 


IGGPSLIV builds the volume list from the end of the 
work area to the beginning, thus allowing the sorting 
of entries by device type both within and outside the 

minimum unit count. 


IGGOCLAM: IGGPSLOC 


If an error is detected, the procedure detecting the 
error returns control immediately to the calling 
procedure. IGGPSLOC returns to the caller of 
SUPERLOCATE. 


If no error is detected and the request was for a single, 
nonVSAM entry, the data set's DSCB TTR is returned 
to the caller. IGGPSLEL (IGGOCLAM) sets the 
indicator for returning the TTR and saves the DSCB 
TTR in the SUPERLOCATE work area. 


For additional information about topics related to 
SUPERLOCATE processing, see: 


“Data Areas:”’ 
Catalog record descriptions and formats 
‘Diagnostic Aids:”’ 


Catalog management return codes 
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Diagram DGS: LOCATE Based on a Generic Name 
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Notes for Diagram DG5 


When the caller specifies LOCATE-by-generic-name, 
IGGPGLOC is called to process the request. The caller’s 
CTGPL points to a work area. When IGGPGLOC 
returns to the caller, the work area contains a list of 
cataloged data set DSNAMEs identified by the generic 
name. 


1 IGGOCLA2: IGGPGLOC (calls IGGPDBVC 
(IGGOCLAM)) 


2 IGGOCLA2: IGGPGLCN 


The DSNAME of the catalog being searched is put 
into the caller's work area. Each cataloged-object 
DSNAME identified by the caller-supplied generic 
name is then put into the caller’s work area. 


3 IGGOCLA2: IGGPGLOC 
IGGOCLA2: IGGPGLOC 


The caller specifies the catalogs to be searched for 
DSNAMESs identified by the generic name. 


5 IGGOCLA2: IGGPGLOC (calls IGGPSC2 (IGGOCLA3)) 


IGGPSC2 searches the PCCB chain to find the next 
caller-specified catalog and connect the caller’s request 
to it. If the specified catalog isn’t open, IGGPSC2 
opens it. 


6 IGGOCLA2: IGGPGLOC 


If the caller's work area isn't large enough to contain 
all of the DSNAMEs found, IGGPGLOC sets the 
appropriate return code and puts the required length 
in the CCA. 
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Diagram DG6: Locate a Generation Data Set’s Catalog Record 
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Notes for Diagram DG6 


When the caller specifies a relative DSNAME (in the 
form “‘dsname(n)”) that identifies a generation data set 
(nonVSAM), IGGPGDGL is called to locate the record 
identified by the DSNAME. The caller specifies 
‘*dsname(0)’ to locate the latest generation data set, 
““dsname(-1)’ to locate the next latest generation data set, 
etc. The caller can also specify a starting point, or ““zero 
level’, generation. The zero-level generation thus defined 
becomes the latest generation data set. 

If the generation data set is being created, IGGPGDGL is 
called to convert the relative DSNAME to an absolute 
DSNAME in the form “dsname.GxxxxVyy”. The 
OS/VS2 Scheduler encounters the relative DSNAME ina 
JCL statement (the relative DSNAME is usually 
**dsname(+1)”.) The OS/VS2 Scheduler issues a 
SUPERLOCATE command to catalog management, 
pointing to the relative DSNAME. Catalog management 
returns to the Scheduler with the data set’s absolute 
DSNAME in the form ““dsname.GxxxxVyy”. 
Subsequently, the OS/VS2 Scheduler issues a DEFINE 
NONVSAM command to create a nonVSAM 
(generation) data set with the DSINAME 
‘““dsname.GxxxxVyy’. 


1 IGGOCLA2: IGGPGTAB 


The GDG base catalog record contains a 
variable-length header field. This field consists of 1- or 
2-byte entries that identify each generation data set in 
the group and specify whether the data set is 
cataloged. 


2 IGGOCLA2: IGGPGRGN 


If the caller specified a zero-level generation, 
IGGPGRGN updates the generation level table to 
reflect the new zero-level generation. 


4 IGGOCLA2: IGGPGFND 


If the caller didn’t specify a generation data set (the 
caller specified an unqualified DSNAME), 
IGGPGFND determines the number of generations 
that are cataloged and returns this information to the 
caller. 


Cc 


IGGOCLA2: IGGPGDGL 


The caller-supplied relative DSNAME is in the form 
‘dsname(n)’ where ‘n’ identifies the generation data 
set. The generation data set’s cataloged DSNAME is 
in the form “‘dsname.GxxxxVyy’ where ““Gxxxx’ is the 
generation number and “‘Vyy’ is the version number. 


IGGOCLA2: IGGPGGE 
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Diagram DH1. UPDATE: Modify Catalog Information 
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Notes for Diagram DH1 


IDA0200T 7 IGGOCLAX: IGGPALT2 


3 IGGOCLAV: IGGPSFPL 
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The VSAM Close routine uses VSAM catalog 
management to modify the data set and index statistics 
maintained in the catalog record’s copy of the 
AMDSB. 


See VSAM Close Processing, in OS/VS2 VSAM Logic, 
for details about disconnecting a user from a VSAM 
cluster (Close processing). 


IDA0557A 


The VSAM EOV routine uses VSAM catalog 
management to obtain more space for a data set. 


See VSAM End-of-Volume Processing, in OS/VS2 
VSAM Logic, for details about end of volume 
processing. 


IDA0192A 


The VSAM Open routine uses VSAM catalog 
management to reset a VSAM data set. See ““VSAM 
Open Processing” in OS/VS2 VSAM Logic for details 
about Open Processing. 


IGGOCLAB: IGGPACDV (calls IGGPUPD 
(IGGOCLAV)) 


When the caller issues the CATLG macro instruction, 
register 1 points to the caller’s catalog parameter list 
(CTGPL). The CTGPL request options are decoded 
and the base catalog record is retrieved for the 
request. See Diagram DB1, VSAM Catalog 
Management Overview, for a description of initial 
catalog management processing and request decoding. 


IGGOCLAV: IGGPUPD (calls IGGPUPDE 
(IGGOCLBB)) 


If more space is required for the data set, the 
UPDATE—Extend routine processes the caller’s 
update request, and returns to IGGPACDYV in 
IGGOCLAB. 


IGGOCLAV: IGGPUPD (calls IGGPRUS (IGGOCLB7)) 


If a VSAM data set must be reset, the UPDATE-Reuse 
routine processes the caller's update request and 
returns to IGGPACDV (IGGOCLAB). 


IGGOCLAV: IGGPSFPL 


Steps 3 through 8 are performed to update each of the 
catalog record fields identified by the callers CTGFLs. 


The caller's CTGFL list contains the address of each 
CTGFL needed to satisfy the caller's updating 
requirements. Each field parameter list (CTGFL) 
describes one of the catalog record fields to be 
updated. Each CTGFL is completely processed before 
the next one is started. 


IGGOCLAV: IGGPSFPL (calls IGGPTSTS 
(IGGOCLBA)) 


The caller might want to update a field only if another 
field’s value, when compared to the caller’s test value, 
satisfies the caller's test conditions. If so, the caller 
builds a CTGFL that contains the name of the catalog 
field to be tested, the test conditions (equal, high, low, 
etc.), and the address and length of the caller’s test 
value. If a CTGFL contains the address of another 
CTGFL, the second CTGFL describes a catalog 
record field that is to be compared to the caller’s data. 
If the comparison satisfies the test conditions, the 
catalog record field specified by the first CTGFL is 
updated with the caller’s data. 


IGGOCLBA: IGGPTSTS and IGGPTCMP 


If the caller wants to update a catalog record’s header 
field, the field’s data is updated with the caller’s data if 
all tests are satisfied. 


If the caller wants to update a field from one of the 
sets of fields that follow the header field, the field’s 
data is updated with the caller’s data for each set of 
fields’ field that satisfies all tests. The set of fields that 
contains the field to be updated can also be identified 
by its sequence number. 


The sequence number of each set of fields that satisfies 
the tests is put in the CCA. When all sets of fields have 
been tested, the sequence numbers are used to identify 
each set of fields that contains caller-requested data. 


IGGOCLAX: IGGPALT2 


A combination name refers to a set of related catalog 
field names, and is used by the caller instead of a 
separate CTGFL for each field name. 


The CCA’s combination name index has an entry for 
each field name in the combination. The Update 
routine processes each field name entry in the 
combination name index sequentially, starting with 
the index of the first field name entry for the 
combination, and ending when the number of entries 
processed equals the number of field names associated 
with the combination name. 


The combination name’s CTGFL contains the 
beginning address and the total length of the group of 
update data fields in the caller's work area. 


The test sequence (if any) associated with a 
combination-name CTGFL is done only once, not 
once for each field name in the combination. 


IGGOCLAV: IGGPSFPL (calls IGGPPREC 
(IGGOCLAW)) 


When the catalog record is updated (in a buffer in the 
Update routine’s virtual storage) the Update routine 
sets the ‘‘must write” flag on to indicate that the buffer 
must be written from virtual storage into the catalog 
before the buffer can be made available to contain 
another catalog record. When the caller's update 
request is finished, or when the Update routine needs 
the buffer to process another catalog record associated 
with the request, the Update routine calls IGGPPUPC 
or IGGPPAD (IGGOCLAG) to write the catalog 
record from the buffer into the VSAM catalog (on a 
direct-access storage device). 


For additional information about topics related to 
UPDATE processing, see: 


‘Data Areas:” 


Catalog record descriptions and formats 

Catalog parameter list (CTGPL) description and 
format 

Field parameter list (CTGFL) description and 
format 

Catalog communications area (CCA) description 
and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DI]. UPDATE-Extend: Obtain Additional Space for a VSAM Object 
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Notes for Diagram DI1 


The UPDATE-Extend routine is called whenever a 
VSAM object (cluster, data set, index, or catalog) needs 
more space to store its records. 


The VSAM end of volume routine calls the 
catalog-management Update routine, and an amount of 
space, based on the object’s direct-access space allocation 
requirements, is allocated from one of the following 
sources: 


» Ashared VSAM data space that has enough free space 
to satisfy the allocation requirements 


« Ashared VSAM data space, extended to satisfy the 
allocation requirements from the free space on the 
object’s currently mounted volume 


« Anew VSAM data space, created to satisfy the 
allocation requirements, on the object’s currently 
mounted volume. 


See VSAM End-of-Volume Processing, in OS/VS2 
VSAM Logic, for EOV processing details. 


1 IGGOCLBB: IGGPUPDE (calls IGGPINIT 
(IGGOCLBC)) 


2 IGGOCLBB: IGGPUPDE (calls IGGPSVOL 
(IGGOCLBC)) 


The volume information set of fields is identified by 
volume serial and key ranges, if this is a key-range 
data set. 


3 IGGOCLBB: IGGPUALL 


A shared (nonunique) VSAM data space contains all 
or parts of two or more VSAM objects. A unique 
VSAM data space contains all or part of only one 
VSAM object, and is not allowed to contain records of 
another object. 


4 IGGOCLBB: IGGPCSAL (calls IGGPSALL 
(IGGOCLAR)) 


If the object shares its data space with other VSAM 
data sets or indexes, there might be enough free space 
in one of the data spaces on the volume to satisfy the 
object’s direct-access space allocation requirements. 


C 


IGGOCLBB: IGGPUPDE 


If there is not enough free space, another extent is 
obtained for one of the volume’s data spaces, or a new 
data space is created. 


IGGOCLEB: IGGPUPDE 


If any data space on the volume has less than 12 
extents, the data space can be extended. 


IGGOCLBB: IGGPUPDE 


If a new extent was obtained for one of the volume’s 
data spaces or a new data space was created, this 
space is suballocated to the object (nonunique) or 
given directly to the object (unique). For recoverable 
catalogs, the data set directory of the object is updated 
with a new sum total track value. For nonrecoverable 
catalogs, the format-4 timestamp field is updated on 
the physical volume. 
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Diagram DI2. UPDATE - Extend: Obtain Additional Space for a VSAM Object 
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Notes for Diagram DI2 
11 IGGOCLBB: IGGPMVOL For additional information about topics related to 


If a key range data set obtains space from a candidate UPD ied Ese xte nd prOcessilie see: 
volume, the second, third, fourth, etc., key range that “Data Areas:” 

obtains space from that candidate volume for the first 
time will require a new volume information set of 
fields. Note that each key range on each different 


Catalog record descriptions and formats 
Volume information set of fields description and 


volume ts described by an individual volume format 
information set of fields. “Diagnostic Aids:” 
12 IGGOCLBB: IGGPMVOL Catalog management return codes 


The object’s catalog record contains a volume 
information set of fields to describe the object’s space 
on each volume that contains a part of the object. If 
the object’s newly obtained extent is in a key range on 
a new volume, the UPDATE-Extend routine may 
build (see step 11) a volume information set of fields 
to describe the new volume and extent. Otherwise, an 
existing volume information set of fields is updated 
with the high-allocated RBA and extent information in 
the form: 


SS CCHH CCHH DDDD DDDD 
where: 
SS identifies the VSAM data space. 


CCHH are the low and high cylinder and track 
addresses. 


DDDD are the low and high RBAs. 
16 IGGOCLBB: IGGPSSWD 


The low and high CCHH addresses (in the index 
catalog-record’s volume information set of fields) are 
those of the extent obtained for the data set. The low 
and high RBA values are for the sequence set. 
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Diagram DI3. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI3 


Reusable is an attribute that may be assigned to a VSAM 
data set or an alternate index. This attribute allows the 
data set to have its high-used RBA set to zero at open 
time, if the user specifies the RESET option. The 
indicator for REUSE is retained in the attributes field of 
data and index records of a key-sequenced data set and an 
alternate index and in the data record of an 
entry-sequenced and relative record data set. Reusable 
data sets may be multi-volumed and they must be 
suballocated only. That is, reusable data sets may not be 
unique. Also, reusable data sets cannot have key ranges 
and they are restricted to a maximum of 16 physical 
extents per volume. If a base cluster is defined as 
reusable, it may not have alternate indexes associated 
with it; however, it is permissible to define reusable 
alternate indexes that are related to a nonreusable base 
cluster. 


1 IGGOCLAV: IGGPUPD (calls IGGPRUS (IGGOCLB7)) 


Initially, the data set catalog record is available in a 
catalog management buffer. 


4 If the data set is not reusable but is empty, the caller's 
LOCATE request is processed. No error codes are 
returned. 


8 IGGOCLB7: IGGPRUS (calls IGGPEXT (IGGOCLAZ)) 


The reuse work area is set up by IGGPRUS and 
appropriate pointers are initialized. The reuse work 
area includes CTGPL and CTGEFLs required by 
Modify and Extract logic. 
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Diagram DI4. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI4 
12 IGGOCLB7: IGGPRUS (calls IGGPEXT (IGGOCLAZ)) 


The reuse work area provides space for a volume 
information set of fields that contains a maximum of 
16 extent descriptors. 


13 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBD) 
17 IGGOCLB7: IGGPRUS (calls IGGPMOD (IGGOCLAV)) 
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Diagram DIS. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI5 


19 The flag field in the volume information set of fields 
indicates whether sequence set is with data. If so, no 
resetting of the space map Is necessary, since the space 
map will have been set already from the corresponding 
data set volume information set of fields. This is also 
true for the relative track sum in the case of a 
recoverable catalog. 


21 IGGOCLB7: IGGPRUS (calls IGGPSSCR (IGGOCLBF)) 
23 IGGOCLB7: IGGPRUS (calls IGGPTNXO (IGGOCLBD) 


If the reset volume is a candidate volume, the 
computed sum in the CCA will be zero. 
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Diagram DI6. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI6 

28 IGGOCLB7: IGGPRUS (calls IGGPMOD (IGGOCLAV)) 
30 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBD) 
32 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBI)) 
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Diagram DJ1. 
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SUBALLOCATE: Obtain Additional Space from a Nonunique VSAM Data Space 
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Notes for Diagram DJ1 


The Suballocate routine is called to assign a candidate 
volume to a VSAM object (cluster, data set, index, or 
catalog) and to assign available space to a VSAM object 
from one of the data spaces on the caller-specified 
volume. The caller, either the UPDATE-Extend routine 
(see Diagram DI1) or the DEFINE CLUSTER routine 
(see Diagram ED1), builds a list of volume serial numbers 
to identify each volume to be assigned to the object as a 
candidate volume. If the caller requests space allocated to 
the object, the list contains one volume serial number. 


1 IGGOCLAR: IGGPSALL 


The volume entry record may already exist in the 
RAB, having been put there by the caller of 
suballocate. 


2 IGGOCLAR: IGGPSALL 


If the volume entry record is not in the RAB, a call is 
made to IGGPGET (IGGOCLBI) to get the record. 


4 IGGOCLAR: IGGPSALL 


If the request is to assign available space to an object 
from a specified volume, IGGPSALL calls 
IGGPSALS (IGGOCLAU). 


5 IGGOCLAR: IGGPSALL 


If the volume catalog record already contains a Data 
Set Directory Entry set of fields, the volume either is 
already assigned to the VSAM object as a candidate 
volume or has some of its space allocated to the 
VSAM object. 


6 IGGOCLAR: IGGPSALL 


If a Directory Entry already exists for the data set, the 
return code is set in the user-provided volume serial 
number list. 


7 IGGOCLAR: IGGPSALL 


IGGPSALL calls IGGPISCI (IGGOCLAG) and 
IGGPMOD (IGGOCLAYV) to add the new data set 
directory entry to the volume catalog record. 


C 


For additional information about topics related to 
suballocate processing, see: 


“‘Data Areas:” 


Data Set Directory Entry set of fields description 
and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DJ2. SUBALLOCATE: Obtain Additional Space from a Nonunique VSAM Data Space 
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Notes for Diagram DJ2 
9 IGGOCLAU: IGGPSALS 


If the amount of space requested is a number of 
cylinders, convert it to a number of tracks. 


10 IGGOCLAU: IGGPSALS (calls IGGPEXT (IGGOCLAZ)) 


The extent table is built by retrieving each extent 
descriptor (from each Data Space Group set of fields) 
that might contain enough free space to satisfy the 
requests minimum allocation requirement (the 
number of tracks in one control area). 


All extents of shared data spaces are described in the 
table until either there are no more extents to describe 
or the table is full. [f the table is full, step 10 is 
repeated when steps 11 through 14 are completed, 
until the extents of all shared data spaces have been 
examined. 


11 IGGOCLAU: IGGPEDS (calls IGGPBMR (IGGOCLBR)) 


Each extent descriptor in the extent table is in the 
form: 


S# TT NN 
where: 


S# is the sequence number of the data space’s 
extent. 


TT is the extent’s starting track number. 
NN _ is the number of tracks in the extent. 


The extent descriptors are processed beginning with 
the lowest TT value in the table, then the next lowest, 
etc., until all extent descriptors have been processed. 


IGGPBMR examines each extent to find an amount of 
contiguous unallocated tracks at least as large as the 
request’s minimum allocation unit. IGGPBMR 
examines the Space Map set of fields, starting at bit 
position (track indicator) TT and ending at bit 
position (track indicator) TT+NN-1 (usually the 
extent’s track boundaries). If IGGPBMR finds a large 
enough amount of unallocated tracks, it returns to 
IGGPEDS with the beginning track number (TT) and 
the number of tracks (NN). If the data space’s extent 
might contain another amount of unallocated tracks at 
least as large as the request’s minimum allocation unit, 
IGGPEDS calls IGGPBMR again to examine the rest 
of the data space’s extent. 
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12 IGGOCLAU: IGGPEDS 


If the extent returned by IGGPBMR is the exact 
number of tracks required to satisfy the caller’s 
request, no further extent table processing is done. 
Larger or smaller extents obtained from previous 
extent-table entries are ignored. 


13 IGGOCLAU: IGGPEDS 


If the extent returned by IGGPBMR is larger than the 
amount of tracks required to satisfy the request, the 
extent is saved if either: 


¢« No other “‘larger-than-requested-amount” extent 
has been returned yet, or 


« The current extent is smaller than a previously 
obtained “‘larger-than-requested-amount” extent. 


In either case, only one “‘larger-than-requested- 
amount” extent value is saved. The “small extent 
table” (built in step 13) is ignored and no longer used. 


14 IGGOCLAU: IGGPEDS 


If the extent returned by IGGPBMR is smaller than 
the amount of tracks required to satisfy the request, its 
TTNN value is adjusted so that TT is on a cylinder 
boundary. If NN is now at least as large as the 
request’s minimum allocation unit (number of tracks 
for one control area), the extent is saved in the “‘small 
extent table” if: 


« The table has fewer than five entries (or a 
caller-specified maximum less than five), or 


e The table is full and the current extent’s NN value 
is greater than the table’s smallest extent’s NN 
value. The current extent replaces the table’s 
smallest extent. 


In either case, the extent is not put in the “‘small extent 
table” if it is too small (adjusted NN is less than the 
minimum allocation unit) or if a “‘larger-than- 
requested-amount” extent already exists (see step 12). 


If, after all data spaces have been examined, the total 
of the NN values in the “small extent table” is less 
than the amount required to satisfy the request, no 
space is allocated to the object. 
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17 IGGOCLAU: IGGPSALS (calls IGGPBMR 


(IGGOCLBR)) 


If the selected extent is larger than or equal to the 
amount of space requested, IGGPBMR adjusts the 
Space Map set of fields starting at bit position (track 
indicator) TT, turning off NN bits (NN is the exact 
number of tracks required to satisfy the request). 


If the space is allocated to an object from a number of 
extents, the ‘small extent table” is sorted so that the 
largest NN value is first, the smallest last. IGGPBMR 
then adjusts the Space Map set of fields for each 
TTNN value in the “‘small extent table,” until the 
amount of allocated tracks equals the amount of tracks 
requested. 


18 IGGOCLAU: IGGPSALS 


IGGPSALS returns the sequence number of the data 
space’s extent, starting track number, and number of 
tracks for each extent obtained for the request. The 
caller uses this information to build extent descriptor 
entries in the VSAM object’s volume information set 
of fields. 
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Diagram DK1. LSPACE: Build an ‘‘ Available Space’’ Report 
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Notes for Diagram DK1 


1 


IGGOCLBK: IGGPLSP and IGGPLDCE 


The volume catalog record describes each VSAM data 
Space, and its free space, on the volume. 


IGGOCLBK: IGGPLDCS, IGGPLSMS, IGGPLDAS 


Each data space entry derived from the volume 
catalog record has a field that describes the available 
space in the data space. The LSPACE routine analyzes 
each data space entry and calculates the amount of 
available space in cylinders and tracks. It also records 
the number of cylinders and tracks in the longest 
continuous amount of available space. 


IGGOCLBK: IGGPLEMP 


A diagnostic message describing the error which 
occurred during the building of the available space 
report is placed in the caller's work area. 


IGGOCLBK: IGGPLDCE, IGGPLSMP 


If the caller provides a 30-byte work area, the 
available-space report is put into the work area in the 
form: 


SPACE-CCCC,TTTT,AAAA/cccc, tttt 
where: 


« CCCC is the number of cylinders of free space in 
all VSAM data spaces on the volume. 


e TTTT its the number of tracks in addition to the 
number of cylinders of free space on all VSAM 
data spaces on the volume. 


« AAAA is the number of extents of free space in all 
VSAM data spaces on the volume. 


* cccc is the largest number of contiguous freespace 
cylinders on the volume. 


¢ tttt is the number of contiguous freespace tracks in 
addition to the cccc value. 


IGGOCLBK: IGGPLSP (calls IGGPSMFL (IGGOCLBV)) 


See OS/VS2 System Programming Library: System 
Management Facilities for details about SMF record 
type 69. 


IGGOCLBK: IGGPLSP 


For additional information about topics related to 
LSPACE processing, see: 


“‘Data Areas:”’ 
Volume catalog record description and format 
“Diagnostic Aids:”’ 


Catalog management return codes 
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Diagram DL1. Obtain a Catalog Record Field’s Value 
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Notes for Diagram DLI 


The Get-Field-Value routine is called by other catalog 
field management routines to obtain the location and 
length of a field in a catalog record. The record is in 
virtual storage in a catalog management buffer. The 
following results could occur: 


¢ The field is entirely contained in the record in the 
buffer, and the field’s address and length are set in the 
caller's CCA. 


e The field is partially contained in the record in the 
buffer, and the field’s address and partial length are set 
in the caller’s CCA. The CCA also has the “‘not 
complete” flag on and contains the control-interval 
number of the catalog record’s extension, which 
contains more of the field. 


e The field is not retrieved because it doesn’t exist in the 
caller-specified set of fields, or because there are no 
more sets of field in the record, or because no buffer 
space is available to contain an extension record. 


1 IGGOCLBS: IGGPXVAL 


If the field name is derived, the field information to be 
returned does not exist in the physical catalog record 
but must be generated from the catalog fields, possibly 
in different catalog records. Derived field names exist 
only in the volume entry. 


2 IGGOCLBA: IGGPLVAL 


The field name dictionary is a read-only catalog 
management table. The catalog field name dictionary 
contains an entry for each type of catalog record field, 
based on its field name. The caller puts the dictionary 
entry identified by the CTGFL’s field name into the 
CCA before calling the get-field-value routine. 


If the field name identifies a header field, the field’s 
type code (in the field name dictionary entry) is zero 
(0). A nonzero type code identifies a set of fields that 
contains the field identified by the CTGFL’s field 
name. 


3 IGGOCLBA: IGGPLVAL 


If the field name identifies a header field, and the field 
is fixed-length, it is at a fixed displacement from the 
beginning of the catalog record. 


The field’s address is obtained by adding the 
displacement in the CTGFL’s dictionary entry to the 
beginning address of the record (the CCA’s CCACPE]1 
value). The field’s length is part of CTGFL’s 
dictionary entry. 


cr 


If the field name identifies a header field, and the field 

is variable length, the field’s address is obtained by 

using the sequence number in the CTGFL’s dictionary 
entry, which indicates that the field is the first, second, 
etc., variable-length field. | 


IGGOCLBA: IGGPLVAL 


The set of fields pointer (GOP) is used to locate a set 
of fields. The pointers are grouped together by group 
code. Within each group of pointers, the pointers are 
ordered by sequence number. 


IGGOCLBA: IGGPLVAL 


If the caller-specified set of fields pointer 
(GOP)—identified by its sequence number— is found, 
its displacement field and flags field specify the 
location of its set of fields as: 


e« the number of bytes from the beginning of the 
record's sets of fields (the CCA’s CCACPE3 value 
plus the set-of-fields pointer’s (GOP’s) 
displacement-field value), or 


e the control interval number of the extension record 
that contains the set of fields. The extension record 
contains a set-of-fields pointer (GOP) that specifies 
the set of field’s location as a number of bytes from 
the beginning of the record’s sets of fields. 


IGGOCLBA: IGGPGVAL 


An extension record might contain the set of fields 
with the field to be retrieved. 


IGGOCLBA: IGGPGVAL 
IGGOCLBA: IGGPGREC 


Each catalog record (in a catalog management buffer) 
is identified by a record area block (RAB) within the 
CCA. The RAB contains flags that indicate whether or 
not the buffer can be used to contain another record. 

If the RAB’s “‘must write” flag is on, the buffer cannot 
be used for another record until its contents have been 
written into the catalog. 


IGGOCLBA: IGGPGVAL 


Each catalog control area (CCA) contains six record 
area blocks (RABs). Each catalog management 
request can use a maximum of five buffers. If all 
buffers are filled and cannot be released, the 


get-field-value routine sets the CCA's “‘no buffer 
space” flag on. 


9 IGGOCLBA: IGGPGVAL 
10 IGGOCLBA: IGGPGREC 


The CCA’s ‘‘not found” flag is set off before returning 
to step 4 to examine the extension record’s set of fields 
pointers (GOPs). 


For additional information about topics related to 
field location processing, see: 


‘Data Areas:” 


Catalog field names, their descriptions, and the 
dictionary entry format 

Catalog record description and format 

Catalog Communications Area (CCA) description 
and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DL2. Obtain a Catalog Record Field’s Value 
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Notes for Diagram DL2 
11 IGGOCLBA: IGGPLVAL 


If the set of fields pointer contains the control interval 
number (CI#) of an extension record, the set of fields 
is in that extension record. 


12 IGGOCLBA: IGGPGVAL 


IGGOCLBA: IGGPGREC 


Each catalog record (in a catalog management buffer) 
is identified by a record area block (RAB) within the 
CCA. The RAB contains flags that indicate whether or 
not the buffer can be used to contain another record. 
If the RAB’s “must write” flag is on, the buffer cannot 
be used for another record until its contents have been 
written into the catalog. 


IGGOCLBA: IGGPGVAL 


Each catalog control area (CCA) contains six record 
area blocks (RABs). Each catalog management 
request can use a maximum of five buffers. If all 
buffers are filled and cannot be released, the 


get-field-value routine sets the CCA's “no buffer 
space” flag on. 


13 IGGOCLBA: IGGPGVAL 
14 IGGOCLBA: IGGPGREC 


The CCA’s “‘not found” flag is set off before returning. 
to step 4 to examine the extension record’s set of fields 
pointers (GOPs). 


15 IGGOCLBA: IGGPLVAL 


The field’s length is obtained from the CTGFL’s 
dictionary entry (for a fixed-length field) or the first 2 
bytes of the field (which are the length bytes of a 
variable-length field). The field’s address is the sum of 
the address of the set of fields and the displacement in 
the CTGFL (for a fixed-length field); or is first, 
second, etc. (as indicated in the CTGFL), 
variable-length field (for a variable-length field). 


16 IGGOCLBA: IGGPLVAL 


A variable-length field might be partially contained in 
an extension record. If so, the field’s length is greater 
than the number of bytes remaining in the record. 


17 IGGOCLBA: IGGPLVAL 


C 


18 IGGOCLBA: IGGPLVAL 


The caller’s information requirements might be 
satisfied with the part of the field that is currently 
available. If not, the caller (a catalog management 
routine) returns to the get-field-value routine to obtain 
the next part of the field from the extension record. 


19 IGGOCLBA: IGGPLVAL 


The caller can move that part of the field currently in 
the buffer into a work area. If the rest of the field is 
required, the caller can return to the get-field-value 
routine to retrieve the extension record. 


For additional information about topics related to 
field location processing, see: 


“Data Areas:” 


Catalog Communications Area (CCA) description 
and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram DM1. Modify a Catalog Record Field’s Value 
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Notes for Diagram DM1 


1 IGGOCLAV: IGGPMOD (calls IGGPXMOD 
(IGGOCLBT)) 


For newly-created volume entries, deleted set-of-fields 
pointers are inserted for the bit map set of fields to 
ensure that the base volume entry (V) contains the bit 
map set-of-fields pointers. This bit map set of fields is 
dynamically added when the first data space set of 
fields is added. 


2 IGGOCLAV: IGGPMOD (calls IGGPSCNC 
(IGGOCLAY)) 


Each CTGFL is initialized with the dictionary entry 
associated with the CTGFL’s field-name value. 


3 IGGOCLAV: IGGPMOD (calls IGGPSFPL 
(IGGOCLAV)) 


The field parameter list (CTGFL) contains the field’s 
name, type code, length, and displacement from the 
beginning of the record or set of fields in the case of a 
fixed-length field. For a variable-length field, contains 
the field’s name, type code, and sequence number. If 
the field exists, it is either a header field (type code = 
0) or a field within a set of fields. If the caller supplied 
modifying data and test conditions, the field is being 
altered. If the caller supplied modifying data and no 
test conditons, a set of fields is to be added to the 
record. If the caller identified a set of fields 
combination field name but didn’t supply modifying 
data, the set of fields is being deleted. 


4 IGGOCLAV: IGGPSFPL (calls IGGPXDGO 
(IGGOCLBT) which in turn calls IGGPADGO 
(IGGOCLAW)) 


Every new set of fields is examined by the 
derived-field processing routine (IGGPXDGO) before 
being passed on to the normal add field processing 
routine (IGGPADGO). The derived-field processing 
routine ensures that certain volume set of fields are 
never added, added in a different format, or cause 
dynamic addition of a different set of fields (i.e., bit 
map set of fields). 


5 IGGOCLAW: IGGPAGOP 


If a new set of fields pointer is built, it is put into the 
catalog record at the end of its group of set-of-fields 
pointers. The set-of-fields pointers are grouped by type 
code with the codes in sequence number order. 


C 3 c 


10 IGGOCLAV: IGGPSFPL 


If there are no more CTGFLs to process, IGGPSFPL 
calls IGGPPREC (IGGOCLAW) to write each 
updated catalog record into the catalog. 


If the new set of fields pointer causes the catalog 
record to overflow, an extension record is obtained 
from the catalog’s free control intervals to free some 
space in the overflowed catalog record for this new 
set-of-fields pointer. Some or all sets of fields in the 
original record are put into the extension record. The 11 IGGOCLAYV: IGGPSFPL 
set-of-fields pointer’s displacement value (in the 
original record) is replaced with the control interval 
number of the extension record, for those sets of fields 
that are moved to an extension record. 


For additional information about topics related to 
field modification processing, see: 


‘*Data Areas:” 


Catalog record description and format 
Set-of-fields descriptions and formats 
Set-of-fields pointer description and format 


In addition, a set-of-fields pointer is built and put into 
the extension record for each set of fields in the 
extension record. The set-of-fields pointer in the 
extension record contains the displacement from the 
beginning of the sets of fields in the record to its set of 
fields. 


If the new set-of-fields pointer causes the original 
catalog record to overflow and the catalog record 
contains only set-of-fields pointers, an extension 
record is obtained to contain the new set-of-fields 
pointer (GOP). The original record’s extension field 
contains the control interval number of the extension 
record. 


IGGOCLAW: IGGPAGOP (calls IGGPIGOP 
(IGGOCLAW)) 


The modify routine activates the set of fields pointer 


by setting it’s “inactive” flag off. 
IGGOCLAW: IGGPADGO 


IGGOCLAW: IGGPADGO (calls IGGPMVGO 
(IGGOCLAW)) 


The new set of fields might contain fixed-length fields 
and variable-length fields. 


‘Diagnostic Aids:” 


Catalog management return codes 


If the new set of fields causes the record to overflow, 
an extension record is obtained to contain the new set 
of fields. 


IGGOCLAW: IGGPADGO (calls IGGPMVGO 
(IGGOCLAW)) 


Replace the initial field values (from step 7) with the 
caller-supplied values addressed by the CCA. 
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Diagram DM2. Modify a Catalog Record Field’s Value 
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Notes for Diagram DM2 
12 IGGOCLAV: IGGPSFPL (calls IGGPXLT2 (IGGOCLBT) 


which in turn calls IGGPALT2 (IGGOCLAX)) 


Every field to be updated is examined by the 
derived-field processing routine (IGGPXLT2) before 
being passed on to the normal update field processing 
routine (IGGPALT2). The derived-field processing 
routine ensures that certain volume entry set of fields 
are never altered, primarily because the altered fields 
do not physically exist in the catalog records. 


C 


17 IGGOCLAX: IGGPEXPD 


The additional bytes are obtained by reducing the 
record's free space. 


If the increased length causes the catalog record to 
overflow, an extension record is obtained. The 
original record’s data is split so that part remains in 
the original record and part is moved into the 
extension record. Each associated set of fields pointer 
is updated to show the new position of its set of fields. 


IGGOCLAX: IGGPALT2 (calls IGGPGVAL (IGGOCLBA)) 49 1G@GoCLAX: IGGPALT2 (calls IGGPAOCI 


The CCA’s CCACPE7 field contains the field’s 
address. The CTGFL contains the address and length 
of the data to update the field with. 


13 IGGOCLAX: IGGPALT2Z 


The CTGFL flags field (from the catalog field name 
directory) specifies field type. 


14 IGGOCLAX: IGGPALT2 


The CTGFL contains the length and address of the 
updating data. The data is in the caller’s work area. 


15 IGGOCLAX: IGGPMVAR 


The CTGFL flags field (from the catalog field name 
directory) specifies field type. If the length of the data 
to update the field with (in the CTGFL) isn’t equal to 
the field’s length (in the CCA), the variable-length 
field’s length is either increased or decreased, causing 
a corresponding reduction or increase in the catalog 
record’s amount of free space. 


If the modification occurs in the base catalog record, 
the affected set of fields is moved from the base 
catalog record into an extension record. 


The variable-length field’s length bytes are replaced 
with the length of the data to update the field with (in 
the CTGFL). 


16 IGGOCLAX: IGGPSHNK 


The eliminated bytes at the end of the record are 
added to the record’s free space. 


(IGGOCLAG)) 


The catalog control record (CCR) contains the 
control-interval number of the first free control 
interval on the deleted chain. Catalog management 
allocates the free control interval to the original 
catalog record as an extension record. The 
control-interval number of the next free control 
interval is put into the CCR, and the CCR’s free 
control interval count is decreased by 1. 


20 IGGOCLAX: IGGPALT2 


The set of fields’ data is split so that part remains in 
the original record and part is moved into the 
extension record. 


21 IGGOCLAX: IGGPALT2 


Each set of fields pointer is updated to show the new 
position of its set of fields. 


For additional information about topics related to 
field modification processing, see: 


‘‘Data Areas:” 


Field Parameter List (CTGFL) description and 
format 
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Diagram DM3. Modify a Catalog Record Field’s Value 
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Notes for Diagram DM3 


22 IGGOCLAV: IGGSFPL (calls IGGPXEL2 (IGGOCLBT) For additional information about topics related to 


which in turn calls IGGPDEL2 (IGGOCLAVY)) 


Every set of fields to be deleted is examined by the 
derived field processing routine (IGGPXEL2) before 
being passed on to the normal delete set of fields 
processing routine (IGGPDEL2). The derived field 
processing routine ensures that certain nonexistent 
sets of fields are not deleted and that the bit map set of 


field modification processing, see: 
‘Data Areas:” 


Catalog record description and format 
Extension catalog record description and format 


‘Diagnostic Aids:” 


Catalog management return codes 
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fields is updated. 
IGGOCLAV: IGGPDEL2 


The set of fields pointer’s “inactive” flag is set on, 
thereby deactivating it. The set of fields pointer’s type 
code and sequence number fields are unchanged. The 
set of fields is removed from the record and the 
displacement field is set to 0, if the set of fields is in 
the same record as the set-of-fields pointer; otherwise, 
the following is done: 


23 IGGOCLAV: IGGPDEL2 


If the extension record contains no data after the set of 
fields is removed, the record is reclaimed by catalog 
management as a free control interval. 


25 IGGOCLAV: IGGPDEL2 
26 IGGOCLAV: IGGPDEL2 


The catalog contains ‘‘once used but now free” control 
intervals. These are control intervals that have been 
deleted. The catalog control record (CCR) contains 
the count of deleted control intervals available to the 
catalog and the control interval number of the first 
deleted control interval. All deleted control intervals 
are chained together in the catalog. When a control 
interval is added to the deleted control interval chain, 
catalog management puts the CCR’s deleted control 
interval number into the new deleted control interval 
and puts the new deleted control interval’s 
control-interval number into the CCR. The CCR’s 
deleted-control-interval count is increased by 1. 


If a deleted variable-length field in a set of fields spans 
several extension records, those extension records are 
deleted also. 


27 IGGOCLAV: IGGPMOD 
28 


The modify routine returns to the caller (a catalog 
management routine) when the catalog record fields 
are updated. 
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Diagram EA1. Catalog Management Services Table of Contents 
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Diagram EB1. Catalog Management Services Overview 
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Notes for Diagram EB1 


Catalog Management Services is a group of OS/VS2 
catalog management modules that respond to Access 
Method Services commands. The Catalog Management 
Services Driver routine, IGGPCDVR (IGGOCLAT), calls 
other Catalog Management Services routines as described 
in the table below. 


For additional information about topics related to 
Catalog Management Services—overview — 
processing, see: 


“Data Areas:” 


Access method control block (ACB) description 
and format 


“Diagnostic Aids:” 


Catalog management return codes 


Access Method IGGOCLAT 
Services Command Calls 
DEFINE CLUSTER, IGGOCLAL 
AIX, PATH, 

PAGESPACE, 

and DEFINE 

USERCATALOG 

DEFINE CRA IGGOCLB4 
DEFINE NONVSAM IGGOCLBH 
DEFINE ALIAS IGGOCLAO 
DEFINE IGGOCLA4 
GENERATIONDATAGROUP 

DEFINE SPACE “ IGGOCLAQ 
ALTER IGGOCLBD 
LISTCAT IGGOCLBQ 
DELETE ALIAS IGGOCLAS 
DELETE CLUSTER, IGGOCLBG 
AIX, PATH, 

PAGESPACE, 

and DELETE 

NONVSAM 

DELETE IGGOCLAS5 
GENERATIONDATAGROUP 

DELETE SPACE IGGOCLBL 
DELETE IGGOCLAF 
USERCATALOG 

CONVERTV IGGOCLBZ 


Related 
Method of 
Operation 
Diagram 
ECI 


EE3 
EF1 
EF2 
EF3 


EGI 
EHI 
Ell 
EM1 
EJ1 


EN1 


EK1 
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Diagram EB2. Catalog Management Services Overview 
Create an OS/VS2 User Catalog 


6. Does the caller want to create an OS/VS2 user 
Virtual Storage for the Caller’s Program catalog? 
R11 No Yes 
7. Search the master catalog to ensure that the 
new catalog’s DSNAME doesn’t duplicate an 
CCA existing DSNAME. (See Diagram DC1, 
tCTGPL “Search: Retrieve a Catalog Record.”’) 
—— 8. Did the search routine set the no-record-found 
Return 
error code? 
Yes No 
CTGPL oie CCAPROB 


Data Needed 
to Create a 
Catalog or 
Data Set 


| Return to the caller. Ay 


0. Build the OS/VS2 user catalog. (See Diagram 
EC1. “DEFINE: Create a Catalog or Cluster.’’) 


Request 

Type 

t CTGFV \ 

t Catalog’s &) 
DSNAME 


CCAPROB 
11. Return to the caller. Ba 


Identifies 
the Catalog 


to be 
Searched 


“Search: Retrieve a Catalog Record.’’) 


13. Did the search routine set the no-record-found 
error code? 


Yes No 


_ CCAPROB 
14. Return to the caller. Baws 


15. Process the DEFINE command to create: 


Catalog, AIX, Path or, Cluster.’’) 


“DEFINE NONVSAM: Define a NonVSAM 
Data Set in a catalog.”’) 

@ A catalog recovery area. (See Diagram EE3, 
““DEFINE CRA: Create a Catalog Recovery 
Area.”’) 

@ An alternate name for a user’s catalog or 


Data Set with an Alternate DSNAME.’’) 
@ A generation data group (See Figure EF3, 
“DEFINE GENERATIONDATAGROUP: 
Create a Generation Data Group.’’) 


CCAPROB 


16. Return to caller. BZ 


DBI 
10 


12. Search the catalog specified in the caller's CTGPL 
to ensure that the new data set’s DSNAME doesn't 
duplicate an existing DSNAME. (See Diagram DCI, 


@ A cluster (a VSAM data set, with or without an 
index). (See Diagram EC], ‘“‘DEFINE: Create a 


@ A nonVSAM data set. (See Diagram EFIl.--—~_> 


nonVSAM data set (See Figure EF2, ““DEFINE 
ALIAS: Identify a User’s Catalog or NonVSAM 


VSAM Master 
Catalog 


User-Catalog 
Catalog 
Record 


VSAM Catalog 
Identified by 
the CTGPL 


Cluster Record: 
Describes the 
New VSAM 
Cluster 


NonVSAM Re- 
cord: Describes 
the New Non- 
VSAM Data 
Set 


VSAM-Owned 
Direct-Access 
Volume 


Data Space 


VSAM User 
Catalog 


Space 
Allocated 

to the New 
VSAM Cluste 


NonVSAM 
Direct-Access 
Volume Identified 
by Caller’s 
CTGEV 


Space Allocated 
to NonVSAM 
Data Set 
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Diagram EB3. Catalog Management Services Overview 


VSAM Catalog 
ey Process an ALTER, DELETE, LISTCAT, SHOWCAT, or Identified by the 


CONVERTYV Request CPL's Catalog 


Virtual Storage for the Caller’s Program 
DSNAME Value 


17. Search the catalog specified in the callers CTGPL 
and retrieve the catalog record identified by the 
caller-supplied DSNAME. (See Diagram DC 1, 
“Search: Retrieve a Catalog Record’’’) 

—> 18. Process the command to: 

@® Modify a catalog record. (See Diagram EH 1, 

“ALTER: Modify a Catalog Record.’’) 


tCTGPL + Request ea a aa 
Type 
| Buffer / 


tCTGEV fe 


VSAM-Owned 
Direct-Access 
<> Volume 


data set, or generation data set of a generation data 
group. (See Diagram EJ1, ““DELETE: Remove a 
VSAM or NonVSAM Data Set.’’) 

@ Delete all empty data spaces on a volume. (See 

Diagram EK 1, ‘‘DELETE SPACE: Release All 

Empty VSAM Data Spaces on a Volume.’’) 


@ Delete an OS/VS2 catalog. (See Diagram EL], 
“DELETE CATALOG: Release a Catalog.’’) 

@ Delete a GDG Base Catalog Record. (See Diagram 
ENI, ““SDELETE GDGBASE: Remove a Generation 
Data Group.’’) 

@ Delete an Alias Name Catalog Record. (See Dia- 
gram EM], ““DELETE ALIAS: Remove a Non- 
VSAM Data Set’s or User Catalog’s Alternate 
DSNAME.”’) 

@ Retrieve information from a catalog. (See Diagram 
FI], “LISTCAT: Retrieve a Catalog Record’s 
Contents.”’) 

@ Display selected fields of the VSAM catalog. (See 
Diagram E12, “SHOWCAT: Process a Show 
Catalog Request.’’) 

@ Convert the contents of a direct-access storage 
volume to or from a mass storage volume. (See 
Diagram EO1, “CONVERTV: Convert a Volume 
to or from Mass Storage.’’) 


Catalog 
Record ’s 
DSNAME 


Catalog's 
DSNAME 


identifies the 
Catalog that 
Contains the 
Record to be 
Listed, Altered, 
or Deleted 


Virtual Storage for the Caller’s Program 


Catalog Data 
to Satisfy the 
Caller’s Request 


Data Needed to 
Alter or Delete 
Catalog 
Information 


CCAPROB 


19. Return to the caller, Bee Return Code 


DBI 
10 


Catalog Record to be 
Listed, Altered, or Deleted 
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Diagram EC1. DEFINE: Create an OS/VS2 Catalog, VSAM Cluster, VSAM AIX, or VSAM Path 


ey 
3, ey 
Virtual storage for the caller’s program oa Call IGGPRDEF if the data set is to be RACF- 
4 protected. 


Ril 4. Verify that each of the caller’s CTGFVs: 


“ 
“7 A e Is within the caller-program’s region, and 
CCA 
tCTGPL 
terert | 2. Determine the creation date. ee Creation Date 


(7 7 f ® Contains all the information needed to build the 
CTGPL 7 2.1. Call IGGPRDEF if the data or index name is to be 
Request RACF-protected. 
ye 
nays CTGFVs 3. Did the caller issue a DEFINE CATALOG request? 
See the data ¥ 
areas section 12 Sie le Sarge 
i OS/VS2 catalog 


for a list of 
[| | LY 4. Build the OS/VS2 catalog. (See Diagram EE1, 


iF 


the CTGFVs 


ded t 
eee a VSAM l “DEFINE CATALOG: Create a Catalog.” ) 
object or 
OS/VS2 catalog D> CCAPROB 


§. Returntothe caller. woaw22Z2) Return code 


! 


6. Did the caller issue a DEFINE PATH request? 
Newly-created 
No Yes VSAM path 


(A) 7. Build the VSAM path (See Diagram EDS, ————————> 


“DEFINE PATH: Create a Path.”’) 


OS/VS nucleus 


CCAPROB 
OS/VS2 master. 8. Return to caller. 
talog- 
flag is ON 9. Did the caller issue a DEFINE AIX request? 
Newly-created 
No | VSAM AIX 
(a) 10.. Build the VSAM AIX (See Diagram ED3: al 
“DEFINE AIX: Create an Alternate Index.’’) 
CCAPROB Newly-created 


11. Return to caller FOOOPPTEP VSAM cluster 


(A)——> 12. Build the VSAM cluster (See Diagram EDI: DEFINE———___> 


CLUSTER: “Create a Cluster.’’) 
CCAPROB 


13. Return to caller PIZZZIEZAP) Return code 


c 5 c —— 


at ey / catalog or VSAM object. Creation Date CTGFV 
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Notes for Diagram EC1 


When the user issues the Access Method Services 
DEFINE command to create a catalog (either user or 
master) or a VSAM object, the catalog management 
services DEFINE: Initial Processing modules ensure that 
the caller provided all the information necessary to create 
a catalog or a VSAM object. 


1 IGGOCLAT: IGGPCDVR 


This is done just before calling IGGOCLAL. 
IGGPRDEF will process all user-specified entity 
names, issuing RACDEF SVCs (133) to define these 
entities to the RACF subsystem. 


1.1 CTGFVs are checked by internal procedures in the 
IGGOCLAL and IGGOCLAN modules, as shown in 
the table below. 


2 IGGOCLAL: IGGPDEDE 
2.1IGGOCLAL: IGGPDEDE 


This is done for the user-supplied name or the 
generated name. 


4 IGGOCLAN: IGGPDSCB (calls IGGPDCDA 
(IGGOCLAP) and IGGPDEFC (IGGOCLAS)) 


7 IGGOCLAL: IGGPDDEP 
10 IGGOCLAL: IGGPDCWC 


12 IGGOCLAN: IGGPDSCB (calls IGGPDRDA 
(IGGOCLAN) and IGGPDBDI (IGGOCLAJ)) 


CTGFV Name 
Cluster CTGFV 
AIX CTGFV 
Cailer’s work area 


Data CTGFV 
structure 


Index CTGFV 
structure 


Data dsname CTGFV 
Index dsname CTGFV 
Path CTGFV 

Data space CTGFV 


Catalog’s space 
CTGFV 


Key range CTGFV 


Space parameter 
CTGFLs 


Buffer size CTGFLs 


Average record size 
CTGFLs 
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Module 
IGGOCLAL 
IGGOCLAL 
IGGOCLAL 
IGGOCLAL 


IGGOCLAL 


IGGOCLAL 
IGGOCLAL 
IGGOCLAL 
IGGOCLAL 
IGGOCLAL 


IGGOCLAL 
IGGOCLAN 


IGGOCLAN 
IGGOCLAN 


Procedure 
IGGPDCWC 
IGGPDCWC 
IGGPDCWC 
IGGPDFSC 


IGGPDFSC 


IGGPDDNP 
IGGPDDNP 
IGGPDDEP 
IGGPDBVC 
IGGPDCSF 


IGGPDRPG 
IGGPDSPF 


IGGPDBSF 
IGGPDALR 
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Diagram ED1. DEFINE CLUSTER: Create a Cluster 


CCA 
tCTGPL 
tCatalog’s 
ACB ; 
Describes data 
t Buffer set and index 
space 


requirements 


Describes data 
set and index 
volume usage 
and serial 
numbers 


Catalog management buffers © 


Free catalog record #1 © 


/ 

G) 
Free catalog record #2 

/ 
Free catalog record #3 


NY 


oe the cluster catalog record 
‘©- 


‘On z 5. Build an association set of fields to point to the data 


DE—=> 6. Build the cluster’s password set of fields. 


©@r —y e Build the data set catalog record to describe the data 


y e 
(H)~ set’s index and its assigned space, if the cluster is 


(C}-> 10. Can the data set or index share its space with other 


. Build the cluster’s AMDSB set of fields. 


1 
2. Compute the amount of direct-access space required 


cluster. 


VA 


. Initialize the cluster catalog record’s header fields. 


set catalog record and, if the cluster is key-sequenced, 
the index catalog record. 


= 


a 


. Compute the cluster catalog record’s size. 


. Write the cluster catalog record into the catalog. 


Do steps 9 through 23 to: 


set and its assigned space. 


Build the index catalog record to describe the data 


key-sequenced. 


9. Initialize the catalog record’s header fields. 


Obtain direct-access space to satisfy the data set’s or 
index’s space allocation requirements 


VSAM data sets and indexes? 
No 


¥ 


11. Allocate a VSAM data space to the data set or 
| index. (See Diagram EG1, “DEFINE SPACE: 


Yes 


Initialize a VSAM Data Space.’’) 


. Allocate space to the data set or index from an 
existing VSAM data space. (See Diagram DJ1, 
‘“‘Suballocate: Obtain Additional Space from a 

Nonunique VSAM Data Space.’’) 


work area 
for the cluster. 
AMDSSB set-of-fields 
3. Obtain contiguous free catalog records from the catalog OS 
specified in the caller's CTGPL and assign them to the Amount of space 
needed for the cluster 


Catalog management 


Catalog management buffers 


Cluster catalog record 
Data set catalog record 
‘Index catalog record 


OS/VS2 catalog 
identified by the 
caller’s CTGPL 


New cluster 
catalog record 


VSAM-owned 
direct-access 
volume 


Space allocated 
to the data set 
or index 
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Notes for Diagram ED1 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services DEFINE CLUSTER command 
in the form: 


DEFINE 

CLUSTER 

(parameterlist) 

[CATALOG (catname/password)] 


where: 


* catname is the name of the catalog that will contain 
the cluster, data set, and index catalog records that 
describe the user’s data set. 


¢ password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


° parameterlist is a list of optional and required 
parameters that define the cluster’s characteristics. 


See OS/VS2 Access Method Services for details about the 
DEFINE command parameters. 


Note: When an AMS user issues the DEFINE 
PAGESPACE command, the user wants to identify a 
single-extent amount of direct-access device space called a 
pagespace. The user can then create data sets that reside 
in the pagespace. Catalog management services processes 
a DEFINE PAGESPACE request by creating an 
entry-sequenced data set with fixed-length control 
intervals and track overflow. The pagespace catalog 
record is similar to an entry-sequenced data set’s record, 
except that the record identifier is ““P”. 


1 IGGOCLAN: IGGPDRDA 


The AMDSB contains the cluster’s statistics and fixed 
characteristics. The AMDSB set of fields is in the Data 
catalog record (for an entry-sequenced data set) and in 
the Data and Index catalog records (fora 
key-sequenced data set). Each time the cluster is 
opened, the AMDSB is retrieved from the data set 
catalog record. When the cluster is closed, the 
AMDSSB is updated and rewritten into the data set 
catalog record. 


2 IGGOCLBX: IGGPDSPC 


The field vector table (CTGFV) contains addresses of 
buffer-size and record-length field parameter lists 
(CTGFLs). This data is used to determine the data 
set’s control-interval and control-area size. If the data 
set is key-sequenced, other buffer-size and 
record-length CTGFLs determine the index’s 


C 


control-interval and control-area size. If the 
key-sequenced data set is divided into key ranges, the 
size of each key range is determined. 


IGGOCLBX 


IGGOCLBX determines the amount of secondary 
storage needed. For Pagespaces, IGGOCLBX 
calculates this space using track overflow where 
appropriate. 


IGGOCLBY: IGGPDRSP 


IGGPDRSP is called to calculate the space 
parameters. 


3 IGGOCLAN: IGGPDCCE 


A user's data set is described by a cluster catalog 
record, a data set catalog record, and, if the data set is 
key-sequenced, an index catalog record. 


IGGOCLAG: IGGPAOCI 


IGGPAOCL is called to obtain two (for an 
entry-sequenced cluster) or three (for a key-sequenced 
cluster) contiguous catalog control intervals to contain 
the cluster, data set, and (if the cluster is 
key-sequenced) index catalog records. 


8 IGGOCLAN: IGGPDCCE 


The DEFINE routine issues an ADDREC macro 
instruction to write the cluster record into the catalog. 


9 IGGOCLAJ: IGGPDBDI 
10 IGGOCLAJ: IGGPDSPO 


11 IGGOCLAJ: IGGPDSPO (calls IGGPDEFS 
(IGGOCLAQ)) 


A Data Space Group set of fields is added to the 
volume catalog record, and the data set’s name is 
added to the volume catalog record’s data set 
directory. 


12 IGGOCLAJ: IGGPDSPO (calls IGGPSALL 
(IGGOCLAR)) 


The data set’s name is added to the volume catalog 
record’s Data Set Directory Entry set of fields, and the 
volume catalog record’s Data Space Group set of fields 
is updated to show the cylinders and tracks allocated 
to the new data set or index. 


a C 


For additional information about topics related to 
DEFINE CLUSTER processing, see: 


‘Data Areas:” 


Catalog record description and format 

Data set catalog record description and format 
Volume catalog record description and format 
Data set group set of fields description 

Data set directory entry set of fields description 
Access Method data set statistics block (AMDSB) 
description and format 
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Diagram ED2. DEFINE CLUSTER: Create a Cluster 


Virtual Storage for the Caller’s Program Assign space (continued) Virtual Storage for the Caller’s Program 


Extent 
Descriptors 


Volume Information 
Sets of Fields 


. Build an extent descriptor that describes each extent 
allocated to the data set or index. ~ 


Work Area 


Low and High CCHH 
Values for Each Extent 
Allocated to the Data 
Set, Index, or Data 
Set’s Key Range 


14. If the data set is divided into key ranges, assign space 
to each of the data set’s key ranges. 


CCA 
tWork Area 
t Buffers 
tCTGPL 


tWork Area 
t Buffers 


15. Assign candidate volumes to the data set or index. 

(See Diagram DJ1, “SUBALLOCATE” — Assign a 
Candidate Volume to the Object.) 

uild a volume information set of fields to describe: 


16. 


Extent 
Descriptors 
(From Steps 13 & 14) 


Volume [Information 
Sets of Fields 

(From Steps 16, 17, 
and 18) 


All extents allocated to the data set or index on each 
volume. 


17. All extents allocated to each of the data set’s key 
ranges on each volume. 


18. Each of the data set’s or index’s candidate 
volumes. 


Describes Data Set 
and Index Volume 
Usage and Serial 

Numbers 


19, ls the “sequence set with data” option specified? Catalog Management Buffers 


7” No Yes 


m=, 20. Assign part of each of the data set’s extents 
to the sequence set. 


me VSAM Catal 
21. Put each volume information set of fields into the data Sena te 


set or index catalog record. (See Diagram DM}, Caller’s CTGPL 
“Modify a Catalog Record Field’s Value.’’) 


22. Write the data set or index catalog record into the 
catalog. 


Describes Data Set 
and Index 


Characteristics h; 


tCTGFLs J 


New Data Set 
Catalog Record 
23. Free the virtual storage of the work areas obtained by 


the Define routine. 
Write SMF record type 63 


24. Does the OS/VS system include the system 


management facility (SMF)? 
No Yes 


New Index 
Catalog Record 


Catalog Management Buffers 


Data Set Catalog Record 
Index Catalog Record 


SME Data Set 


Record Type 63 


c , Cc i 4 cL 


er 25. Write SMF record type 63 — Cluster Cataloged. 


CCAPROB 


26. Return to the caller. >| Return Code | 
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Notes for Diagram ED2 
13 IGGOCLAJ: IGGPDSEX 
14 IGGOCLAJ: IGGPDSPO 


Each key range is assigned physical space and space 
allocation continues until all key ranges have been 
assigned space. 


15 IGGOCLAJ: IGGPDCNV 


A candidate volume is available to contain part of the 
cluster if more space is needed later. None of the 
candidate volume’s space is allocated to the data set or 
index when the cluster is created. 


16 IGGOCLAK: IGGPDBVO 


Each volume that contains a part of the data set or 
index is described by a volume information set of 
fields within the data set or index catalog record. 


17 IGGOCLAK: IGGPDRNG 


If the data set is divided into key ranges, each key 
range’s space on a volume is described in a separate 
volume information set of fields. If the key range’s 
space is on more than one volume, each volume that 
contains part of the key range’s space is described ina 
separate volume information set of fields. 


18 IGGOCLAK: IGGPDBCV 


IGGPDBCYV builds a volume information set of fields 
for each candidate volume of the data set. 


20 IGGOCLAK: IGGPDSSP 


If the ‘“‘sequence set with data” option is specified, part 
of the data set’s space is allocated to the index for 
sequence set records. The low and high CCHH values 
in the index record’s volume information set of fields 
are those of the extent obtained for the data set. The 
low and high RBA values are for the sequence set and 
are relative to the index addresses. 


21 IGGOCLAK: IGGPDMOP 


IGGPDMOFP calls IGGPMOD (IGGOCLAYV) to add 
each volume information set of fields to the record. 
22 IGGOCLAK: IGGPDMOP 


A catalog management routine writes the completed 
data set or index catalog record into the VSAM 
catalog and frees the catalog management buffer that 
contains the record. 


23 IGGOCLA8: IGGPDFRS 


IGGPDFRS frees all unneeded storage resources. 
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25 IGGOCLAJ: IGGPDBDI (calls IGGPSMFA 
(IGGOCLBV)) 


See OS/VS2 System Programming Library: System 
Management Facilities for details of SMF record type 
63—VSAM Data Set Cataloged. Record type 63 is 
written after a VSAM cluster is defined and whenever 
the definition is altered. 


For additional information about topics related to 
DEFINE CLUSTER processing, see: 


““Data Areas:” 


Data set catalog record description and format 
Index catalog record description and format 
Volume information set of fields description 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram ED3. DEFINE AIX: Create an Alternate Index 


1. Get base cluster record, verify password, and build the 
AIX’s AMDSB set of fields. 


2. Compute the amount of direct-access space required Catalog Management 
. (B) for the AIX. Work Area 
Virtual Storage for the Caller’s Program 
3. Obtain contiguous free catalog records from the catalog AMDSB Set-of-Fields 


specified in the caller's CTGPL, assign them to the AIX, 
A and build an association set of fields in the cluster record.. 


Describes Data / 

Set and Index i 

rate anns i a er the AIX catalog record 

/ o= 4. Initialize the AIX catalog record’s header fields. 

© 5. Build an association set of fields to point to the 


data set catalog record, the index catalog record, 
(Hy and the related cluster catalog record. 
Describes Dat: 
Ser and index” Dr—> 6. Build the AIX’s password set of fields. 
ulrer 


Space 
Requirements 7. Compute the AIX catalog record’s size. 


CTGPL (F)- 


tCTGFVs 


Amount of Space 
Needed for the Cluster 


Catalog Management Buffers 


Index Catalog Record 


> 8. Write the AIX catalog record into the catalog. 


VSAM Catalog 
Identified by the 
Caller’s CTGPL 


Do steps 9 through 23 to: 


_-> @ Build the data set catalog record to describe the data 
G- set and its assigned space. 
@ Build the index catalog record to describe the data 


(Hy) si set’s index and its assigned space. New AIX 


catalog record 


9. Initialize the catalog record’s header fields. 


Describes Data Obtain direct-access space to satisfy the data set’s or 


Set and Index index’s space allocation requirements 

Volume Usage 

and Serial o> 10. Can the data set or index share its space with other 

Numbers VSAM data sets and indexes? VSAM-Owned 
Direct-Access 


No 


¥ 


11. Allocate a VSAM.data space to the data set or 
| index. (See Diagram EG1, ‘“*~DEFINE SPACE: 


Volume 


Space Allocated 
to the Data Set 


Catalog Management Buffers 


“ 
Free Catalog Record #1 

“ 
Free Catalog Record #2 

“ 
Free Catalog Record #3 


Initialize a VSAM Data Space.’’) 


or Index 


roRoke 


12. Allocate space to the data set or index from an 
existing VSAM data space. (See Diagram DJ, 
“SUBALLOCATE: Obtain Additional Space from 
a Nonunique VSAM Data Space.’’) 


L _ Cc — c 
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Notes for Diagram ED3 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services DEFINE AIX command in the 
form: 


DEFINE 

AIX 

(parameterlist) 

[CATALOG (catname/password)] 


where: 


« catname is the name of the catalog that will contain 
the AIX, data set, and index catalog records that 
describe the user's data set. 


e password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


¢ parameterlist is a list of optional and required 
parameters that define the AIX’s characteristics. 


See OS/VS2 Access Method Services for details about the 
DEFINE command parameters. 


Note: When an AMS user issues the DEFINE 
PAGESPACE command, the user wants to identify a 
single-extent amount of direct-access device space called a 
pagespace. The user can then create data sets that reside 
in the pagespace. Catalog management services processes 
a DEFINE PAGESPACE request by creating an 
entry-sequenced data set with fixed-length control 
intervals and track overflow. The pagespace catalog 
record is similar to an entry-sequenced data set’s record, 
except that the record identifier is ‘‘P”. 


IGGOCLB9: IGGPPRPW 
1 IGGOCLAN: IGGPDRDA 


The AMDSB contains the cluster’s statistics and fixed 
characteristics. The AMDSB set of fields is in the Data 
catalog record (for an entry-sequenced data set) and in 
the Data and Index catalog records (for a 
key-sequenced data set). Each time the cluster is 
opened, the AMDSB is retrieved from the data set 
catalog record. When the cluster is closed, the 
AMDSSB is updated and rewritten into the data set 
catalog record. 


2 IGGOCLAN: IGGPDSPC 


The field vector table (CTGFV) contains addresses of 
buffer-size and record-length field parameter lists 
(CTGFLs). This data is used to determine the data 
set's control-interval and control-area size. If the data 
set is key-sequenced, other buffer-size and 
record-length CTGFLs determine the index’s 
control-interval and control-area size. If the 
key-sequenced data set is divided into key ranges, the 
size of each key range is determined. 


IGGOCLBX 


IGGOCLBX determines the amount of secondary 
storage needed. For Pagespaces, IGGOCLBX 
calculates this space using track overflow where 
appropriate. 


IGGOCLBY: IGGPDRSP 


IGGPDRSP is called to calculate the space 
parameters. 


3 IGGOCLAG: IGGPAOCI 
IGGOCLB9S: IGGPMODC 


IGGPAOCIL is called to obtain three contiguous 
catalog control intervals to contain the AIX, data set, 
and index catalog records. 


8 IGGOCLAN: IGGPDCCE 


The DEFINE routine issues an ADDREC macro 
instruction to write the AIX record into the catalog. 


9 IGGOCLAJ: IGGPDBDI 
10 IGGOCLAJ: IGGPDSPO 


11 IGGOCLAJ: IGGPDSPO (calls IGGPDEFS 
(IGGOCLAQ)) 


A Data Space Group set of fields is added to the 
volume catalog record, and the data set’s name is 
added to the volume catalog record's data set 
directory. 


12 IGGOCLAJ: IGGPDSPO (calls IGGPSALL 
(IGGOCLAR)) 


The data set’s name is added to the volume catalog 
record’s Data Set Directory Entry set of fields, and the 
volume catalog record’s Data Space Group set of fields 
is updated to show the cylinders and tracks allocated 
to the new data set or index. 
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For additional information about topics related to 
DEFINE AIX processing, see: 


‘“‘Data Areas:” 


Catalog record description and format 

Data set catalog record description and format 
Volume catalog record description and format 
Data set group set of fields description 

Data set directory entry set of fields description 
Access Method data set statistics block (AMDSB) 
description and format 
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Diagram ED4. DEFINE AIX: Create an Alternate Index 


Virtual storage for the caller's program Assign space (continued) Virtual storage for the caller's program 


13. Build an extent descriptor that describes each extent 
allocated to the data set or index. 


Work area 


Extent 
descriptors 


Volume information 
sets of fields 


Work area 


Low and High CCHH 
values for each extent 


14. If the data set is divided into key ranges, assign space 
to each of the data set’s key ranges. 


PWerkales allocated to the data ; ; ; tw 
t Buffers set, index, or data 15. Assign candidate volumes to the data set or index. 


t Buffers 


tCTGPL 


set’s key range (See Diagram DJ1, ‘‘Suballocate” — Assign a 
Candidate Volume to the Object.) 


Extent 
descriptors Build a volume information set of fields to describe: 
(from steps 13 &14) ss 


; - 16. All extents allocated to the data set or index on each 
Volume information 


sets of fields volume. 
(from steps 16, 17, 
and 18) 


tCTGFV 


17. All extents allocated to each of the data set’s key 
ranges on each volume. 


18. Each of the data set’s or index’s candidate 
volumes. 


Describes data set 
and index volume 
usage and serial 
numbers 


Catalog management buffers 


Updated data set catalog record 
Updated index catalog record 


ai9. Is the “sequence set with data” option specified? 


7” No Yes 
> 20. Assign part of each of the data set’s extents 
to the sequence set. 
21. Put each volume information set of fields into the data ee preary 


and index set or index catalog record. (See Diagram DM1, ‘‘Modify caller’s CTGPL 
the Catalog Record.’’) 


characteristics : 
caeessecl 22. Write the data set or index catalog record into the 


SS catalog. 
23. Free the virtual storage of the work areas obtained by 
the DEFINE routine. 
Write SMF record type 63 
24. Does the OS/VS system include the system 
management facility (SMF)? 


No Yes 


Describes data set 


New data set 
catalog record 


New index 
catalog record 


Catalog management buffers 


SMF data set 


Record type 63 


Data set catalog record 


Index catalog record 


Vv 
ee 25. Write SMF record type 63 — Cluster Cataloged. 


CCAPROB 


26. Return to the caller. 


L L L 


611 uoneisdyO jo pore 
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Notes for Diagram ED4 
13 IGGOCLAJ: IGGPDSEX 
14 IGGOCLAJ: IGGPDSPO 


Each key range is assigned physical space and space 
allocation continues until all key ranges have been 
assigned space. 


15 IGGOCLAJ: IGGPDCNV 


A candidate volume is available to contain part of the 
cluster if more space is needed later. None of the 
candidate volume’s space is allocated to the data set or 
index when the AIX is created. 


16 IGGOCLAK: IGGPDBVO 


Each volume that contains a part of the data set or 
index is described by a volume information set of 
fields within the data set or index catalog record. 


17 IGGOCLAK: IGGPDRNG 


If the data set is divided into key ranges, each key 
range’s space on a volume is described in a separate 
volume information set of fields. If the key range’s 
space is on more than one volume, each volume that 
contains part of the key range’s space is described ina 
separate volume information set of fields. 


18 IGGOCLAK: IGGPDBCV 


IGGPDBCYV builds a volume information set of fields 
for each candidate volume of the data set. 


20 IGGOCLAK: IGGPDSSP 


If the “sequence set with data” option is specified, part 
of the data set’s space is allocated to the index for 
sequence set records. The low and high CCHH values 
in the index record’s volume information set of fields 
are those of the extent obtained for the data set. The 
low and high RBA values are for the sequence set and 
are relative to the index addresses. 


21 IGGOCLAK: IGGPDMOP 


IGGPDMOFP calls IGGPMOD to add each volume 
information set of fields to the record. 


22 IGGOCLAK: IGGPDMOP 


A catalog management routine writes the completed 
data set or index catalog record into the VSAM 
catalog and frees the catalog management buffer that 
contains the record. 


23 IGGOCLAS8: IGGPDFRS 


IGGPDERS frees all unneeded storage resources. 


Cc 


25 IGGOCLAJ: IGGPDBDI (calls IGGPSMFA 
(IGGOCLBV)) 


See OS/VS2 System Programming Library: System 
Management Facilities for details of SMF record type 
63—VSAM Data Set Cataloged. Record type 63 is 
written after a VSAM AIX is defined and whenever 
the definition is altered. 


For additional information about topics related to 
DEFINE AIX processing, see: 


“Data Areas:” 


Data set catalog record description and format 
Index catalog record description and format 
Volume information set of fields description 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EDS. DEFINE PATH: Create a Path 


WV 


1. Get base cluster or AIX record and verify master 
- 


Virtual Storage for Caller’s Program 


CTGFL password. 


; ’ Catalog Management Buffers 
RGATTR (A) 2. Obtain Free catalog record from the catalog 
—7 specified in the CTGPL and assign it to the path. Path Catalog Record 
- 
Updated Cluster or AIX Record 


Catalog Identified 
by CTGPL 


New Path 
Catalog 
Record 


Build the Path Record 
As 3. Initialize the path record header 


fields. 


. Build the association sets of fields. 


. Write the path record into the catalog. 


6. Write SMF record type 63. - 
CCAPROB 


7. Return to the caller. Q2ZZAZZZZZZZZA Return Code 


SMF Data Set 


IZ] Uonvssdg jo poyaW 


C 


Notes for Diagram ED5 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services DEFINE PATH command in the 
form: 


DEFINE PATH (NAME(name) 
PATHENTRY(entryname/password) 
(parameterlist) 


where: 


name specifies the name to be given to the alternate 
index/base cluster pair (i.e., the path). 


entryname specifies the name of the alternate index or 
cluster which is to be considered as the entry to the 
path. 


password specifies the master-level password. 


parameterlist is a list of optional and required 
parameters that define the path’s characteristics. 


See OS/VS2 Access Method Services for details about the 
DEFINE command. 


1 
2 


IGGOCLB9: IGGPPRPW 
IGGOCLAG: IGGPAOCI 


IGGPAOCL is called to obtain one catalog control 
interval to contain the path record. 


IGGOCLB9: IGGPBAWP 
IGGOCLB9: IGGPBAWP and IGGPBAMC 


Builds an association set of fields to point to the 
cluster and index records and, if the cluster is 
key-sequenced, the index record. If the path is being 
built over the AIX, then the pointers to the AIX, the 
AIX data, and the AIX index records are also 
included. An association set of fields is also built in the 
cluster or AIX record to point to the path record. 


IGGOCLB9: IGGPBAWP 


The DEFINE routine issues a modify with a put/add 
option to insert all the association sets of fields into 
the path record and to write the record into the 
catalog. These association sets of fields had been 
extracted previously from the cluster and the AIX 
records, if the path is being built over an AIX. 


IGGOCLBV: IGGPSMFA 


Record type 63 is written after a VSAM path is 
defined. 
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Diagram EE1. DEFINE CATALOG: Create an OS/VS2 Catalog 
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LA write it into the master catalog. ay” sets of fields 


Describes catalog 
space requirements 


\/ 


Build the catalog’s cluster catalog record (CI #2) 


. Initialize the cluster record’s header fields. 
5. Build an association set of fields to point to the 
catalog’s data set catalog record (CI#0) and index 
catalog record (CI#1). 
6. Build the catalog’s password set of fields. 
. Compute the cluster record’s size. 


VSAM-owned 
direct-access volume 


Forma 
DSCB 


VSAM data space 


Describes catalog’s 

passwords 
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(from steps Catalog volume’s 
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12 and 13) Se phase es allocated to the 
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& 8. Initialize a VSAM data space. (See Diagram EGI, 


information (F) 
sets of fields IN “DEFINE SPACE: Initialize a VSAM Data Space.”’) 
(from step 14) (G) >) 
9. Assign part of the data space to the catalog. 
Catalog management buffers 
I“ User-catalog catalog recoras 10. Is the catalog recoverable? 
CI#0 Catalog’s No Yes 
through “~~ self-describing 
C1#8 catalog records \ L... Diagram EE3, “DEFINE CRA: 
cova | Suamrscimer < Create a Catalog Recovery Area. 
catalog record 7 
11. Assign part of the catalog’s space to each part of & 


ee x Low keyrange y 
~~ data records High key- 
‘ene 


range data 
12. Build a volume information set of fields to describe —' Records available records 
Ox, each part’s assigned space (from step 13). 


Extent 


Space map set of fields 
for the volume (exten- 
sion of volume catalog 
record—CI#9) 


CI#10 
-13 


clusters, volumes, 
and nonVSAM 
records data sets 


True-name 
records 


13. Build the catalog records that describe the catalog as a 
key-sequenced data set with two key ranges. 


c c 
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Notes for Diagram EE! 


This figure describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE 
USERCATALOG command in the form: 


DEFINE 

USERCATALOG 
(PARAMETERLIST) 
[CATALOG (catname/password)] 


where: 


catname is the DSNAME of the OS/VS2 master 
catalog, which will contain the catalog record that 
describes the OS/VS2 user catalog. 


password is the master catalog’s master, control 
interval, or update password, if the master catalog is 
protected by passwords. 


parameterlist fields are described in OS/VS2 Access 
Method Services. 


IGGOCLAP: IGGPDCDA 


The AMDSB contains the catalog’s statistics and fixed 
characteristics. Each time the catalog is opened, the 
AMDSSB is retrieved from the catalog’s data set 

catalog record (control interval number 0). When the 
catalog is closed, the AMDSB is usually updated and 
rewritten into the data set catalog record. VSAM 
Close processing contains a performance enhancement 
that determines whether or not the catalogs AMDSB 
needs to be updated. 


IGGOCLAP: IGGPDCSP 


The field vector table (CTGFV) contains addresses of 
buffer-size and record-length CTGFLs. This data is 
used to determine the catalog’s control-interval and 
control-area size, and the amount of space required 
for the catalog. 


IGGOCLAP: IGGPDCPC 
IGGOCLAN: IGGPDCCE 


The cluster catalog record contains an 
associated-data-set set of fields to locate the catalog’s 
data set catalog record (control interval number 0) and 
an associated-index set of fields to locate the catalog’s 
index catalog record (control interval number 1). 


C 


8 IGGOCLAS: IGGPDCSP (calls IGGPDEFS 
(IGGOCLAQ)) 


The OS/VS2 catalog is always built in a data space 
that can contain other VSAM data sets and indexes. A 
new data space is allocated to VSAM by the OS/VS 
DADSM Allocate routine, and the data space is 
assigned to the new catalog. 


9 IGGOCLAS: IGGPDCSP( calls IGGPSALL 
(IGGOCLAR)) 


A Data Set Directory Entry set of fields containing the 
cluster’s control interval number is added to the 
volume catalog record. 


10 IGGOCLAS: IGGPDCSP (calls IGGPDCRA 
(IGGOCLB4)) 


11 IGGOCLAS: IGGPDCLD 


The catalog might contain records that describe user's 
VSAM data sets, user's nonVSAM data sets, 
direct-access volumes, and (in the master catalog) user 
catalogs. 


12 IGGOCLAS: IGGPDCVO 
13 IGGOCLAS: IGGPDCBE 


These records define the catalog as a key-sequenced 
VSAM data set, describe the space allocated to the 
catalog’s data records, index records, and true-name 
records, describe the free space control intervals 
within the catalog’s data space, and describe the 
allocated and unallocated tracks on a catalog’s 
volume. 


For additional information about topics related to 
DEFINE CATALOG processing, see: 


“Data Areas:” 


Catalog record description and format 

Cluster catalog record description and format 
User-catalog catalog record description and format 
Volume catalog record description and format 
Data space group set of fields description 

Data set directory entry set of fields description 
First preformatted records in the catalog 

Access method data set statistics block (AMDSB) 
description and format 
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Diagram EE2. DEFINE CATALOG: Create an OS/VS2 Catalog 


Virtual storage for the caller’s program / 


ACB (from 
step 16) 


Describes 
the catalog 


RPL (from 
step 16) 
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t Buffer 


ar 
type 


Catalog management buffers 


Catalog’s self-describing 
catalog records 
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7% catalog DSNAME and the data space’s volume serial 


“318. Close the catalog’s ACB. (See “Close: Disconnect a 


Open the Catalog 


. Build the control blocks to allow the catalog to be 
opened and processed as a VSAM data set. 


. Open the catalog’s ACB to allow catalog records to 
be written. (See “Open: Connect a User toa VSAM 
Data set,” in OS/VS2 VSAM Logic.) 


SRL caw 


tACB 


. Write the catalog’s self-describing records (built in step 
15) into the catalog. 
17. Build and write true-name catalog records for the 


number. 
Opened OS/VS2 catalog 


User from a VSAM Data Set,” inOS/VS2 VSAM Logic.) 


Catalog’s sef-describing 
catalog records 


19. Delete the control blocks built in step 16. 
Write SMF record type 63 


20. Does the OS/VS system include the system 
management facilities (SMF)? 


No Yes 


21. Write SMF record type 63 — Cluster Cataloged. 


SMF Data set 


CCAPROB 


22. Returntothecaller, 22222222222 


soon ree 
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Notes for Diagram EE2 
14 IGGOCLAE: IGGPDCCB 
15 IGGOCLAE: IGGPDCCB 


The ACB describes the catalog as a VSAM data set to 
VSAM record management routines. 


16 IGGOCLAE: IGGPDCPR 
17 IGGOCLAE: IGGPDCPR 
21 IGGOCLBV: IGGPSMFA 


See OS/VS2 System Programming Library: System 
Management Facilities for the format of SMF record 
type 63—VSAM Data Set Cataloged. Record type 63 
is written after an OS/VS2 catalog is defined (for the 
cluster, data, and index components) and whenever 
the catalog’s definition is altered. 
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The catalog management services Define routine sets 
a return code CCAPROB and returns to the caller 
whenever an error is detected. 


For additional information about topics related to 
DEFINE CATALOG processing, see: 


“Data Areas:” 


True-name catalog record description and format 
Access method control block (ACB) description 
and format 

Catalog auxiliary work area (CAXWA) description 
and format 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EE3. DEFINE CRA: Create a Catalog Recovery Area 


Virtual Storage for Caller’s Program 


ormat-4 
DSCB 


36. Compute the CRA’s high-used RBA. 


Acquire Space for the CRA 


1. Is the caller DEFINE CATALOG? 
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2. Is the DEFINE SPACE request for a unique 
data space or for a candidate volume? 


No Yes 


3. Call DEFINE SPACE for 1 cylinder 
of space for the CRA. 


. Suballocate 1 cylinder of space for the CRA. 


5. Update the volume’s format-4 DSCB to show the 
location of the CRA Baga (A) 


7. Construct the CRA self-describing records. 


8. Construct an ACB and a CAXWA for the CRA 
OPEN. 


9. OPEN the CRA. 


10. Write the CRA self-describing records and the 
volume base and extension records into the CRA. Egge@eeeZ 


11. Is the caller DEFINE SPACE? 
No Yes 


12. Write the volume records to the catalog. 


13. Return to caller. e2zzZZZZZ> -CAPROB 
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Notes for Diagram EE3 
1 IGGOCLB4: IGGPSTRG 
2 IGGOCLB4: IGGPSTRG 
3 IGGOCLB4: IGGPRDEF 


If the caller is DEFINE SPACE and the request is for 
a unique data space or for a candidate volume, 
IGGPRDEF will construct an interface to recursively 
call DEFINE SPACE (IGGPDEFS(IGGOCLAQ)) to 
obtain one cylinder of space for the CRA. 


4 IGGOCLB4: IGGPSBAL 


Suballocate one cylinder for the CRA from the data 
space. 


5 IGGOCLB4: IGGPFMT4 
IGGOCLBU: IGGPF4RD, IGGPF4WR 
IGGOCLB4: IGGPCHIU 
IGGOCLB4: IGGPCCIO, IGGPCH15 
IGGOCLDA: IGGPMODI 


The CRA self-describing records are constructed in 
core storage; the MODIFY function is called via 
IGGPMODI to complete the record construction. 


8 IGGOCLB4: IGGPCACB, IGGPCXWA 


An ACB and a CAXWA are built in a catalog 
management buffer for use by OPEN. 


9 IGGOCLB4: IGGPDCRA 
10 IGGOCLDA: IGGPWCRA 


The CRA self-describing records are written to the 
volume. The volume base and extension records are 
also written to the CRA. For a DEFINE CATALOG 
caller, the records are pointed to by an address array 
in the CMS work area; for the DEFINE SPACE caller, 
the volume records are chained from a pointer in the 
CCA. 


12 IGGOCLDA: IGGPWCAT 


The chained volume records are also written into the 
catalog if DEFINE SPACE is the caller. 
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Diagram EF1. DEFINE NONVSAM: Define a NonVSAM Data Set in an OS/VS2 Catalog 
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a meee 
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No Yes 


NonVSAM 
record 
GDG base 
record 
Free 
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7. Remove generation(s) from the GDG base catalog 
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data set: 


Catalog’s index 
records 


Free catalog 
record 
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in the group, or 
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catalog record 
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records 


(See Diagram EJ1, DELETE: Remove a catalog 
record) 


CCAPROB 
8. Return to the caller. =a—2e22222—> 


nonVSAM data set’s 


Seesien toe 
Data set’s | RBA of the 
Index DSNAME ] true-name record 
record Data set’s | Control interval number 
i DSNAME | of the nonVSAM record 


Control 
interval 


number of 
nonVSAM 
record 


6Z1 YoResadg jo poy 


r | 


Notes for Diagram EF 1 


This figure describes the processes performed by the 
catalog management Services routines when the user 
issues the Access Method Services DEFINE NONVSAM 
command in the form: 


DEFINE 
NONVSAM (parameterlist) 
[CATALOG (catname/ password)] 


where: 


catname is the DSNAME of the catalog that will 
contain the nonVSAM catalog record that describes 
the user's nonVSAM data set. 


password is the catalog’s master or update password, if 
the catalog is protected by passwords. 


parameterlist fields are described in the appropriate 
Access Method Services books. 


IGGOCLBH: IGGPDEFA, IGGPDAIN and IGGPDAVO 


The DEFINE NONVSAM routine builds and transfers 
the nonVSAM catalog record from a catalog 
management buffer in virtual storage to the catalog 
specified by the callers DEFINE command. 


If the nonVSAM data set is being defined in a 
recoverable catalog, the catalog’s volume serial and 
device type are saved in the nonVSAM catalog record. 


IGGOCLBH: IGGPDEFA 
IGGOCLBH: IGGPDEFA 
IGGOCLBH 


When a data set generation is added to the GDG base 
catalog record, IGGOCLBH builds an association set 
of fields that points to the generation data set’s catalog 
record and adds the association set of fields to the 
GDG base catalog record. 


IGGOCLBH 


If the number of generations (association sets of 
fields) in the GDG base catalog record exceeds a limit, 
IGGOCLBH calls IGGOCLBG to delete the earliest 
generation data set. The user can also specify the 
deletion of all generations (except the one being 
defined) in the group when the number of generation 
data sets exceeds a maximum number. 


Note: This figure also describes the processes 
performed when the user issues an IMPORT 
command to connect a user catalog (created on 
another OS/VS system and defined in that system’s 
master catalog) to the master catalog. This process is 
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similar to defining a nonVSAM data set, and should 
not be confused with the process described in Diagram 
EE!, DEFINE CATALOG: Create an OS/VS2 
Catalog. 


The user catalog record is similar to the nonVSAM 
catalog record, except the record’s ID (identifier) 
value is ‘‘U” and there is one volume information set 
of fields to describe the volume containing the user 
catalog. 


For additional information about topics related to 
DEFINE NONVSAM processing, see: 


‘‘Data Areas:” 


Catalog index record description 
NonVSAM catalog record format and description 
True-name catalog record description and format 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EF2. DEFINE ALIAS: Identify a User’s Catalog or NonVSAM Data Set with an Alternate DSNAME 
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Notes for Diagram EF2 


This diagram describes the processes performed by 
catalog management services routines when the user 
issues the Access Method Services DEFINE ALIAS 
command in the form: 


DEFINE 

ALIAS 

(parameterlist) 

[CATALOG (catname/ password)] 


where: 


e catname is the DSNAME of the catalog that contains 
the nonVSAM data set’s catalog record for which this 
command will specify an alias name. 


¢ password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


¢ parameterlist fields are described in the appropriate 
Access Method Services books. 


The DEFINE ALIAS command is used to establish an 
alternate DSNAME for a nonVSAM data set or user's 
catalog. The command cannot be used with VSAM data 
sets, data spaces, or the master catalog. 


If the alias is being defined in a recoverable catalog, the 
catalog’s volume serial and device type are saved in the 
alias catalog record. 


1 IGGOCLAO: IGGPDEFX 


The data set’s or user catalog’s real dsname is used to 
locate its true name catalog record. 


2 IGGOCLAO: IGGPDEFX (calls IGGOCLAG): 
(IGGPAQCI) 


3 IGGOCLAO: IGGPDEFX 


IGGOCLAO: IGGPBCFI (calls IGGOCLAY): 
(IGGPMOD) 


6 IGGOCLAO: IGGPBCFI (calls IGGOCLAY): 
(IGGPMOD) 


IGGPBCFI builds association sets of fields to point to: 


¢ The object’s catalog record (containing the object’s 
real DSNAME). 


e The previously-built alias name catalog record for 
the object. If this is the object’s first alias, this set 
of fields contains a contro! interval number 
(pointer) equal to zero. 


e The next alias name catalog record for the object. 
This set of fields contains a control interval number 


Cc 


(pointer) equal to zero. When the next alias for the 
object is specified (with a DEFINE ALIAS 
command), this set of fields is updated to point to 
the newly-built alias name catalog record. 


7 IGGOCLAO: IGGPDEFX 


For additional information about topics related to 
DEFINE ALIAS processing, see: 


‘Data Areas:” 


Catalog parameter list (CTGPL) description and 

format 

Alias name catalog record description and format 

True-name catalog record description and format 
‘Diagnostic Aids:” 


Catalog management return codes 


d 
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Diagram EF3. DEFINE GENERATIONDATAGROUP: Create a Generation Data Group 
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Notes for Diagram EF3 


This diagram describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE 
GENERATIONDATAGROUP in the form: 


DEFINE 
GENERATIONDATAGROUP 
(parameterlist) 

[CATALOG (catname/password)] 


where: 


* catname is the name of the catalog that is to contain 
the GDG Base catalog record which this command 
creates. 


¢ password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


¢ parameterlist fields are described in OS/VS2 Access 
Method Services. 


The DEFINE GENERATIONDATAGROUP command 
is used to create a generation data group (GDG). A 
generation data group is a collection of nonVSAM data 
sets that have similar DSNAMEs, in the form 
‘dsname.GxxxxVyy’.. All data sets in the group have the 
same ‘dsname’. Each data set is uniquely identified by its 
generation number *Gxxxx’ and its version number ‘Vyy’. 
Each data set (a generation data set) is described by a 
nonVSAM catalog record identified by its absolute 
DSNAME (‘dsname.GxxxxVyy’). The user’s program can 
refer to a generation data set with its relative DSNAME, 
*dsname(n)’, where ‘n’ is a negative or positive integer. 


The DEFINE GENERATIONDATAGROUP command 
builds a generation data group (GDG) base catalog 
record. The GDG Base catalog record is used to identify 
all generation data sets described in the catalog. 


1 IGGOCLA4: IGGPDEFB 


The GDG Base catalog record header fields are 
initialized with the generation data group attributes, 
the maximum number of generation data sets allowed 
to exist at the same time, and the size of the 
variable-length generation-level table. The generation 
data group's DSNAME identifies the GDG base 
catalog record. 


If the GDG base record is being defined ina 
recoverable catalog, the catalog’s volume serial and 
device type are saved in the GDG base catalog record. 


C 


IGGOCLA4: IGGPDEFB 


When IGGPDEFB finishes completes the 
initialization of the GDG Base record, IGGPDEFB 
issues the ADDREC macro instruction to write the 
GDG Base record into the catalog, to build and write 
a true name catalog record, and to update the catalog’s 
index records. The ADDREC macro instruction 
results in a call to IGGPPAD (IGGOCLAG). 


For additional information about topics related to 
DEFINE GENERATIONDATAGROUP processing, 
see: 


“Data Areas:” 


GDG Base catalog record 

True Name catalog record 

Catalog parameter list (CTGPL) description and 
format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram EG1. DEFINE SPACE: Initialize a VSAM Data Space 
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New VSAM 
data space 


Virtual storage for the define space routine 


Buffer 


Volume 
catalog 
record 


Volume catalog record 
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‘““NonISAM Data Set Allocation.’’) 


VSAM user’s 
data volume 


CCA 


Low/high CCHH 


values for the 
VTOC Format 4 allocated data 
DSCB space 


Freespace 


SE] Uoneiedg jo poyiy 


e 


Notes for Diagram EG1 


This diagram describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE SPACE 
command: 


DEFINE 
SPACE (parameterlist) 
[CATALOG (catname/password)] 


where: 


catname is the DSNAME of the catalog that contains 
the volume catalog record that will describe the VSAM 
data space. 


password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


parameterlist fields are described in OS/VS2 Access 
Method Services. 


IGGOCLAQ: IGGPDEFS and IGGPVMTV 
IGGOCLA6: IGGPCRTC 


The user can specify the data space’s cylinder and 
track requirements, or he can specify a number of 
records and the length of each record, to define the 
data space’s allocation requirements. 


IGGOCLAQ 


If a volume catalog record exists for the volume, and if 
the volume already contains a VSAM data space, a 
Data Space Group set of fields is added to the volume 
catalog record to describe the new VSAM data space. 
A new format-1 (identifier) DSCB is added to the 
volume’s VTOC to describe the new extent. 


IGGOCLAQ: IGGPCOBT 


If the volume is a candidate volume (one that is 
eligible to contain a VSAM data space, but doesn’t yet) 
the volume’s format-4 (VTOC) DSCB is updated to 
show that the VSAM catalog is now the volume 
owner. 


IGGOCLAQ: IGGPIVER 


IGGOCLAQ: IGGPDEFS (calls IGGPSCAT 
(IGGOCLAH)) 


The volume catalog record is identified by the 
volume’s serial number. 


Cc 


7 IGGOCLA6: IGGPBJFB 
IGGOCLAQ: IGGPDEFS 


Construct a JFCB and call the DADSM allocate 
function. 


For additional information about topics related to 
DEFINE SPACE processing, see: 


‘‘Data Areas:” 


Volume catalog record description and format 
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Diagram EG2. DEFINE SPACE: Initialize a VSAM Data Space 
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Data Set 
Attributes 


11. Write the format-1 (identifier) DSCB into the 
volume’s VTOC. 


(For VSAM 
Data Space 
Initialization) 


Data Set’s 
DSNAME 


> 12. Build a data space entry in the volume catalog 
record to describe the data space’s cylinder and 
track allocation. 
>13. Ils the data space assigned exclusively to one 
data set? 
No Yes 


4 


14. Build a data set directory entry in the 
volume catalog record to describe the 
data set’s use of the data space. 


(E) VSAM User’s Data 
OS/VS2 Catalog Volume 


Volume 
Catalog Format-1 DSCB 
Record 


16. Does the OS/VS system include the system SMF Data Set 


management facilities (SMF)? ae 


No Yes 
Record Type 69 


15. Write the volume catalog record into the 
catalog. 


17. Write SMF record type 69 — VSAM Data 
Space Defined or Deleted. (See Diagram 
DK1, ““LSPACE: Build an ‘Available 
Space’ Report.’’) 


18. Was the defined space for a recoverable 
catalog that just assumed volume owner- 
ship? 


Yes No VSAM-User’s 
Data Volume 


19. Define a CRA on the volume. 
(See Diagram EE3, ““DEFINE CRA: 


Create a Catalog Recovery Area.’’) —_————> Catalog 


Recovery Area 


CCAPROB: 


20. Return to the caller. POLLS LAPP LOLOL LPS 
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Notes for Diagram EG2 


9 


IGGOCLAQ: IGGPDEFS 


The format-! (identifier) DSCB describes the VSAM 
data space as an OS/VS data set to the OS/VS 
DADSM routines. 


IGGOCLAQ: IGGPCOBT 


10 IGGOCLAQ: IGGPCOBT 


A VSAM data space assigned exclusively to one data 
set is, to DADSM, the same as one of the extents of an 
OS/VS data set. The data space is described by a 
format-1 (identifier) DSCB that contains the data set’s 
dsname. If a data space can be assigned to more than 
one data set, its format-1 (identifier) DSCB contains a 
dsname generated by the DEFINE SPACE routine. 


11 IGGOCLAQ: IGGPCOBT 
12 IGGOCLA6: IGGPCSHG and IGGPCSDG 
14 IGGOCLA6: IGGPCDSD 


The volume catalog record contains the identifier of 
each data set that resides (in part or in full) on the 
volume. 


17 IGGOCLAQ: IGGPDEFS (calls IGGPLSP (IGGOCLBK)) 


See OS/VS2 System Programming Library: System 
Management Facilities for the format of SMF record 
type 69—-VSAM Data Space Defined or Deleted. 
Record type 69 is written when a VSAM data space is 
created or when its available space is allocated to a 
VSAM data set or index. 


19 IGGOCLB4: IGGPDCRA 


A catalog recovery area is defined on the volume on 
which the space is being defined if ownership is taken 
by a recoverable catalog and the defined space does 
not contain the catalog. 


C 


For additional information about topics related to 
DEFINE SPACE processing, see: 


‘Data Areas:” 


Volume catalog record description and format 
Data set group set of fields description and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram EH1. ALTER: Modify a Catalog Record 
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Do steps | through 3 for each user-specified field: 


1. Locate the field’s address and length. (See 
Diagram DL1, ‘‘Obtain a Catalog Record 
Field’s Value.” ) 
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2. Do specialized processing: 


@ Change a dataset’s DSNAME ~ dosteps 8 
through 14 
@ Perform volume cleanup do steps 15 
through 19 
@® Assign a candidate volume do steps 20 
through 22 
@ Delete a candidate volume do steps 23 
through 24 


3. Modify other catalog fields as specified, replacing 
the existing information with the updating infor- 
mation. (See Diagram DM1, ‘‘Modify a Catalog 

Record Field’s Value.’’) 


4. Rewrite the updated catalog record. 


5. Does the OS/VS system include the system manage- 
ment facilities (SMF)? 


No Yes 


6. Write SMF record type 63 — VSAM Data Set 
Cataloged. 


——_= 


CCAPROB 


7. Return to the caller. 
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Notes for Diagram EH1 


The ALTER command enables the user to modify some 
of the information he established when he created a 
VSAM data set. 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services ALTER command in the form: 


ALTER 

(entryname/ password) 

| CATALOG (catname/ password) | 
other parameters 


or: 


ALTER 

entryname/ password 

FILE (ddname) 

REMOVEVOLUMES (volser[6volser...]) 


where: 


° entryname is the DSNAME or volume serial number 
that identifies the catalog record to be modified. 


¢ password is the record’s (identified by entryname) 
master password. 


« CATALOG identifies the catalog that contains the 
catalog record to be modified, and supplies the correct 
password for the catalog. 


e other parameters are described in OS/VS2 Access 
Method Services. 


or: 


¢ entryname, for the volume cleanup function, is the 
name of the OS/VS2 master catalog. 


e password is the master password of the master catalog 
specified in entryname. 


« ddname specifies the name of a DD statement that 
identifies the volume(s) to be scratched. This 


parameter is required for the volume cleanup function. 


« volser specifies the volume serial number(s) of the 
volume(s) on which all VSAM space is to be removed 
and VSAM ownership is to be relinquished. Volumes 
owned by the master catalog cannot be specified ona 
cleanup request. 


Note: When a user issues the OS catalog management 
command RECAT, the Catalog Controller converts the 
user-supplied CAMLST into a nonVSAM volume list. In 
this case only, all existing volume information sets of 
fields in the NonVSAM catalog record are deleted and all 
volumes in the nonVSAM volume list are added to the 


cr 


NonVSAM catalog record as volume information sets of 
fields. 


1 IGGOCLBD: IGGPALT 
2 IGGOCLBD: IGGPALT 


When the data set name or allocated candidate 
volumes are changed (in records other than nonVSAM 
catalog records), other catalog records besides the 
object's catalog record must be updated. 


3 IGGOCLBD: IGGPALT 
IGGOCLBD: IGGPALNM 
6 IGGOCLBD: IGGPALT 


See OS/VS2 System Programming Library: System 
Management Facilities for the format of SMF record 
type 63—VSAM Data Set Cataloged. Record type 63 
is written after a nonVSAM data set, cluster, or 
catalog is defined and when the definition is altered. 
One SMF record is written for each modified catalog 
record. 


7 IGGOCLBD: IGGPALT 


For additional information about topics related to 
ALTER processing, see: 


‘Data Areas:” 


Catalog communications area (CCA) description 
and format 

Catalog parameter list (CTGPL) description and 
format 

Field parameter list (CTGFL) description and 
format 


‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EH2. ALTER: Modify a Catalog Record 
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Notes for Diagram EH2 
8 IGGOCLBD: IGGPALNM 


The catalog specified by the ALTER command’s 
CATALOG parameter is examined. The new 
DSNAME cannot already exist in the catalog. 


8.1 IGGOCLBD:IGGPALNM (calls IGGPALRN 
(IGGOCLDD)) 


9 IGGOCLBD: IGGPALNM 


A new true name catalog record is put in the high-key 
range of the catalog. 


11 


All volumes that contain a format 1 DSCB must have 
their names modified in the VTOC label. 


See OS/VS2 Data Areas for details about the DSCB. 
12 IGGOCLBD: IGGPALF1 


The name and control interval fields in the data set’s 
true-name record are set to 0, and the true-name 
record's identifier field is set to “F”. 


14 IGGOCLBD: IGGPALT 


See OS/VS2 System Programming Library: System 
Management Facilities for the format of SMF record 
type 68—VSAM Data Set Renamed. 


C 


For additional information about topics related to 
ALTER processing, see: 


“Data Areas:” 


OS/VS2 catalog organization 

Catalog index record description 

True-name catalog record description and format 
Data set catalog record description and format 
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Diagram EH3. ALTER: Modify a Catalog Record 
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18. Scratch each format-1 DSCB with VSAM 
DSORG on the volume. 


19. Rewrite the format-4 DSCB with VSAM 
ownership relinquished. 


a Assign Candidate Volumes to a Data Set 


20. Confirm that a volume catalog record exists to 
describe each candidate volume. (See Diagram 
DC1, “SEARCH: Retrieve the Base Catalog 

Record.”’) 


OS/VS2 Catalog 


data set’s catalog record identifier to the data 
set directory entries. 


— 
ye 
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22. Update the data set’s catalog record to adda 

volume information set of fields to describe 
the candidate volume. (See Diagram DMI, 
“Modify a Catalog Record Field’s Value.’’) 


Remove Candidate Volume Information From a Data 
Set’s Catalog Record 


23. Update each candidate volume’s catalog record to 
delete the data set catalog record’s identifier from 
the data set directory entries. 


. Update the data set’s catalog record to remove 
each candidate volume’s volume information set 
of fields. (See Diagram DM1, ‘“‘Modify the Catalog 
Record.’’) 
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Notes for Diagram EH3 
15 IGGOCLBE: IGGPALVL 


If volume cleanup is required, IGGPALVL calls 
IGGPVRD (IGGOCLBN). Each volume in the 
user-provided volume serial number list is processed, if 
its volume catalog record exists. 


16 IGGOCLBN: IGGPVRD 


The volume(s) specified in the user-provided volume 
serial number list is mounted. After a successful 
mount, IGGPVRD calls IGGPVRCV (IGGOCLBN). 


17 IGGOCLBN: IGGPVRD 


If a volume cannot be mounted, a 
volume-not-mounted condition is indicated in the 
volume serial list and passed back to the user. 


18 IGGOCLBN: IGGPVRCV 


Scratch each format-1 DSCB that has VSAM DSORG 
indicated. 


20 IGGOCLBD: IGGPALT (calls IGGPALVL (IGGOCLBE)) 
IGGOCLBE: IGGPALVA 


IGGPALVA calls IGGPSALL (suballocate) to assign 
the candidate volume to the data set. If a volume 
catalog record does not exist for the candidate volume, 
the suballocate routine returns an error code. 


See Diagram EG1, DEFINE SPACE: Assign a VSAM 
Data Space to a Catalog, for details on how a volume 
catalog record is built. 


IGGOCLBE: IGGPALVA 


The volume catalog record contains a data set 
directory that describes each VSAM data set’s use of 
the volume’s VSAM space. 


22 IGGOCLBE: IGGPALVA (calls IGGPALSA 
(IGGOCLBE), IGGPSALL (IGGOCLAR), and 
IGGPMOD (IGGOCLAV)) 


23 IGGOCLBN: IGGPALVR 


2 


24 IGGOCLBN: IGGPALVR (calls IGGPMOD 
(IGGOCLAV)) 


C 


For additional information about topics related to 
ALTER processing, see: 


‘‘Data Areas:” 


Data set catalog record description and format 
Volume catalog record description and format 
Volume information set of fields description and 
format 
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Diagram EI1. LISTCAT: Retrieve a Catalog Record’s Contents 


Virtual Storage for the Cailer’s Program 
CTGPL 


Request Options 


GF Virtual Storage for the Caller’s Program 
Caller’s CTGPL 


TDSNAME DSNAME 


—> 1. Did the caller supply the catalog’s DSNAME” Ow 


Yes No - 
‘ 5 
4 . Return the DSNAME to the gine» 
3. Did the caller specify the CTGPL “GET NEXT” Catalog 
option with record type nonzero? Dy—> Work Area 
No. Yes 


“Multitype’? CTGFL 


List of 
Conditions the 
Record Must 


4. Was ‘‘Multitype’” CTGFL specified? 
No Yes To Identify 
each Field 


Meet ‘ 
—> 5. If the catalog record meets the Cae To Identify 
conditions specified in the ‘‘multitype”’ Record Each Field in 
CTGEL, go to step 8; otherwise go to a Data Set, 
Index, Cluster, 
step 7. or User-Catalog 


->6. Is the retrieved catalog record the same Satalge Record 


type as the CTGPL record type? 


Yes No Copy of 
Caller’s 
CTGPL 


CTGFLs 


Catalog Management Buffer 


Record Type | Data | 


\ ae the next catalog record and 
go to step 4. 
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satisfy the caller’s request (see Diagram DL. 
“Obtain a Catalog Record Field’s Value’’). 
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11. Return to caller. LZ 
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Notes for Diagram EI1 


The LISTCAT command enables the user to list all or a 
part of an OS/VS2 user or master catalog’s contents. This 
figure describes the processes performed by the catalog 
management services routines when the user issues the 
Access Method Services LISTCAT command in the form: 


LISTCAT 

CATALOG (catnamel[/password][dname])] 

[OUTFILE (dname) | 

[ENTRIES (entryname[/password]) | LEVEL(level)] 

[CLUSTER | DATA | INDEX | SPACE | 
NONVSAM | USERCATALOG | PATH | 
ALIAS | PAGESPACE | ALTERNATEINDEX | 
GENERATIONDATAGROUP] 

[ALL] NAME | VOLUME | ALLOCATION | 
HISTORY] 

[CREATION (days)] 

[EXPIRATION (days)] 


[NOTUSABLE]} 


where: 


CATALOG identifies the OS/VS2 catalog that 
contains the user-requested data: 


— catname isthe DSNAME of a user catalog or the 
master catalog. 


— password is one of the catalog’s passwords, if the 
catalog is password protected. If the user requests 
password information from the catalog, he must 
specify the catalog’s master password. All other 
catalog information is available to the user if he 
specifies the catalog’s read password. 


dname specifies the DD name of the catalog to be 


listed. 


° 


OUTFILE specifies an optional alternate listing 
output data set and identifies it by dname. 


ENTRIES is a list of catalog record identifiers: 


— entryname is the DSNAME or volume serial 
number that identifies a catalog record. If the 
LISTCAT command includes an ENTRIES 
parameter list, only those catalog records identified 
by entrynames are listed. 


— password is one of the catalog record’s passwords. 
If the catalog’s password is supplied, the catalog 
record's password is ignored. Otherwise, the 
catalog record's master password allows its 
password information to be listed; its read 
password allows all other information to be listed, 
but suppresses the password information. 


* LEVEL (level) specifies the level of entrynames to be 
listed. 


¢ CLUSTER | DATA | INDEX | SPACE | 
NONVSAM | USERCATALOG | PATH | ALIAS | 
PAGESPACE | ALTERNATEINDEX | 
GENERATIONDATAGROUP is a list that specifies the 
types of catalog records to be listed. If both the 
ENTRIES and this “types” parameter list are 
specified, only those catalog records that are identified 
by an entryname and are included in the list of types 
are returned to the caller. 


e ALL | NAME | VOLUME | ALLOCATION | 
HISTORY specifies what part of each record to list. 


¢ CREATION specifies the minimum age an object must 
be to be listed. 


e EXPIRATION specifies the maximum number of days 
remaining before expiration of an object may have to 
be listed. 


¢ NOTUSABLE specifies that only ‘‘not usable” data 
and index entries are to be listed. 


The LISTCAT parameters are described in OS/VS2 
Access Method Services. 


1 IGGOCLBQ: IGGPLSTC 


If the first character of the catalog’s name is blank, the 
caller wants the catalog name returned. 


3 IGGOCLBQ: IGGPLSTC 


If the caller did not specify the CTGPL “GET NEXT”’ 
option and a nonzero CTGPL record type, only the 
one Original entry pointed to by the CTGPL is listed. 


5 IGGOCLBQ: IGGPLSTC 


The multitype CTGFL specifies conditions which must 
be met by the retrieved record. The possible 
conditions are: 


e Must be of a specified record type 

¢ Must have a certain usability state 

e Must meet a creation date value 

e Must meet an expiration date value 
6 IGGOCLBQ: IGGPLSTC 


If there is no multitype CTGFL, the retrieved record 
must be the same record type as the CTGPL record 


type. 


11 


IGGOCLBQ: IGGPLSTC 


The next record is retrieved by specifying the GET 
NEXT option to VSAM Record Management. 


IGGOCLBQ: IGGPLSTC 


If the entry is a volume record, only volume CTGFLs 
are pointed to from the CTGPL; otherwise, only 
nonvolume CTGFLs are pointed to from the CTGPL. 


IGGOCLBQ: IGGPLSTC _ 


When all requested information has been retrieved, 
the LISTCAT routine sets a return code in CCAPROB 
and returns to the caller, Catalog Management 
Services Common Processing. 


For additional information about topics related to 
LISTCAT processing, see: 


‘‘Data Areas:” 


Field parameter list (CTGFL) format and 
description 
Catalog record format and description 


‘*‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EI2. Show Catalog Processing 


Ri, R6 SHOWCAT Macro 


_LINK IGGOCLAO | 


SHOWCAT Parameter List 


Rit 
a 1. Obtain virtual storage for Show Catalog work =F 


CTGPL 
area. 


2. Build VSAM catalog LOCATE interface to 
retrieve required data. RIS 


3. Issue SVC 26. 
if" 


Space for 
SHOWCAT data 


4. Translate VSAM catalog return codes into Show 
Catalog return codes. 


5. Validity-check to ensure that the proper data was 
returned. SHOWCAT Parameter List 


6. Transform data returned by VSAM catalog Locate 
into Show Catalog format. 


7. Free the virtual storage obtained for the Show we a 
‘ we, or 
Catalog work area. RIIS ~ : 
8. Branch register 14. wzzzZ2>| SHOWCAT Return Code NN kaneis 
~~ 
— Return Area Length 
e’AS Required Length 
SHOWCAT Data 
Name/CI sumber 
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Notes for Diagram EJ2 


The Show Catalog processor, IGGOCLAQO, enables the 
user to obtain selected information from the VSAM 
catalog. This specialized user interface is mapped by 
macro IGGSHWPL and is invoked by the SHOWCAT 
macro. See OS/VS Virtual Storage Access Method 
(VSAM) Options for Advanced Applications fora 
complete description of the SHOWCAT macro. 


The SHOWCAT macro generates the Show Catalog 


parameter list and issues a LINK to module IGGOCLAO. 


Note that this module is not a part of the VSAM 
supervisory load module for SVC26, IGGOCLC9. 


1 The Show Catalog processor builds its conditional 


GETMAIN parameter list in the user-provided return 


area. 


2 The VSAM Catalog Locate interface is built in the 
Show Catalog work area acquired in step 1. The 
CTGPL work area address points to the user return 
area. 


3 The VSAM Catalog Locate function sets the required 


return area length field in the user return area and 
places the requested data into this return area. 


4 The Show Catalog processor has equivalent error 
codes for VSAM catalog return codes. 


5 The validity check ensures that data was actually 
returned and that the proper entry type is being 
requested. 


6 The transformation causes upgrade associations and 
nonupgrade associations to be returned in a consistent 


format. 


7 The Show Catalog processor always obtains a fixed 


amount of virtual storage for its work area. The user is 
responsible for providing an area of sufficient size to 


contain the returned data. If his area is not of 
sufficient size, he can use the required return area 


length field to obtain enough virtual storage to reissue 


his request. 


For additional information about topics related to Show 
Catalog processing, see: 


‘Data Areas:”’ 


Catalog parameter list (CTGPL) format and 
description 
Catalog 


‘“Diagnostic Aids:”’ 


Catalog management return codes 
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Diagram EJ1. DELETE: Remove a VSAM or NonVSAM Data Set 


EB3 1. Did the caller specify CLUSTER, PATH, AIX, 
18 4 PAGESPACE, or NONVSAM? 


7 Yes No 


va $ CCAPROB 
2. Return to caller Gattis 
> 3. Is this a recoverable catalog? 
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Yes No CCAPROB 


5. Return to caller PEPER trot Code | 


6. Did the caller specify PURGH? 
Yes No 


Virtual storage for the callers program 


CTGPL 
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PCTGPL 


'Cataloy 
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1 Butfer 


Object Record 


. Is the object record's expiration date value less than 
the current date value? 

No 

4% CCAPROB 


8. Return to calle PIPPLN btror Code | 


9. Did the caller specify “TYPE (NONVSAM)’? 


No ame 


Did the caller specity “TYPE (PATH)? 


CAX 


Recoverable 
Catalog Indicator 


Delete Work Area \ 10. 


Yes 
Data Set Cl = 


Index Cl = 


. Is the data set (index) open? 


. Yes 
vy CCAPROB 
Ea 12. Return to caller G2Z2Z2ZZZO 
13. Did the caller specify ERASE? 
No Yes 


v 


14. Overwrite each data control area in the user’s 


data set with Qs. 
‘Omn 15. Did the caller specify “TYPE (ALTERNATE INDEX)’’? 


No Yes 


Did the caller specify ““TYPE(CLUSTER)’’? 
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7160-9ZNS “INLL Ag 
8L6l “87 Aine pasiaay 
€-978E-9ZAS JO a8eg 


6h] uoHessdO Jo poyrsW 


C 


Notes for Diagram EJ1 


The DELETE command enables the user to remove from 
the catalog all information about a specified VSAM 
object or nonVSAM data set. 


This figure describes the processing performed by the 
catalog management routines when the user issues the 
Access Method Services DELETE command in the form: 


DELETE 

(entryname/ password) 

(CATALOG (camame/password)) 

(CLUSTER | AIX | PATH | PAGESPACE | 
NONVSAM) 


where: 


* entryname is the data set name of the VSAM object or 
nonVSAM data set to be deleted. 


e password is the master password of the VSAM object 
to be deleted. 


° catname identifies the catalog that contains the record 
to be deleted and specifies the catalog’s password. 


« CLUSTER | AIX | PATH |PAGESPACE | 
NONVSAM specifies the type of object to be deleted. 
Deletion of these types is described in this diagram. 
Deletion of other types is described in the following 
diagrams: 


Diagram Type 

EK! SPACE 

EL! USERCATALOG 

EM1 ALIAS 

EN1 GENERATIONDATAGROUP 


The DELETE command’s parameters are described in 
OS/VS2 Access Method Services. 


1 IGGOCLBG: IGGPDEL 


If the CATALOG parameter is not specified, the 
catalog record identified by the ENTRY parameter’s 
entryname is found by a search of each catalog named 
by the user's JCL JOBCAT and STEPCAT DD 
statements, followed by a search of the VSAM master 
catalog. The catalog record identifier is examined to 
determine the record type and verify that the TYPE 
parameter, if specified, is correct. 


Note: When deleting a catalog that has been copied 
onto another direct-access device (the ‘source’ catalog) 
and its ‘target’ catalog hasn't been deleted, IGGPDEL 
regards the ‘source’ catalog as a VSAM data set. The 
catalog can contain catalog records and still be 
deleted. 
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3 IGGOCLBG: IGGPDEL 


If the catalog is a recoverable catalog, a DD statement 
must be specified for the catalog recovery area (CRA) 
volume. 


6 IGGOCLBG: IGGPDEL 


If the user specified PURGE, the data set’s expiration 
date is ignored. See OS/VS2 Access Method Services 
for details about the RETAIN and PURGE parameters. 


7 IGGOCLBG: IGGPDEL 


If the user who created the data set specified the 
expiration date, the data set cannot be deleted until 
after that date (unless the PURGE parameter is 
specified; see step 6). 


9 IGGOCLBG: IGGPDEL 


If the request record type is nonVSAM, go to step 17 
(EJ2). Open determination and Erase processing do 
not apply to nonVSAM data sets. 


10 IGGOCLBG: IGGPDEL (calls IGGPDEPT (IGGOCLBS)) 


If the request record type is PATH, go to step 26 
(EJ3). Open determination, Erase, volume record, and 
release space processing do not apply to path catalog 
records. 


11 IGGOCLBG: IGGPDEL (calls IGGPDOPN 
(IGGOCLBG)) 


If either the data set or the index of the alternate index 
or cluster is already opened, the deletion of the VSAM 
data set will not be allowed. 


13 IGGOCLBG: IGGPDEL (calls IGGPERAS 
(IGGOCLBG)) 


Each of the data set’s control areas is overwritten with 
zeros. 


15 IGGOCLBG: IGGPDEL (calls |IGGPDEAX (IGGOCLB5)) 


Go to step 35 (EJ3) to explicitly delete an alternate 
index from the catalog. An alternate index is very 
similar to a key-sequenced cluster structurally, except 
a base cluster is always associated with an alternate 
index. 


16 IGGOCLBG: IGGPDEL 


If the request type is not a cluster, it must be a 
pagespace, since all other types are processed first. 
Pagespaces are always entry-sequenced clusters 
without associated paths or alternate indexes. It isn’t 
necessary, therefore, to perform implicit delete 
processing for pagespaces. 
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Diagram EJ2. DELETE: Remove a VSAM or NonVSAM Data Set 
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Data Space Group 
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Volume Catalog Record 
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Management 
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VSAM Objects 


Space Map 


1 Release the Data Set’s (Index) Space 
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Do steps 19 through 25 to process each data space 
that contains part of the data set (index) records on 
the volume identified in step 17. 


Is 19. Does the data set (index) share its data space with 
other VSAM data sets or indexes? 


No 


Volume Table 
ot Contents 
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Data Space on an 

OS/VS Data Set 
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| Cl Number of Records | Number of Records 
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OS/VS2 DADSM Logic). 
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space map to show the tracks allocated to the data 
set are now unallocated. QZZZZZZ7A2777AFEAA PAA 
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Notes for Diagram EJ2 
17 IGGOCLA7: IGGPVMSC 
IGGOCLA7: IGGPDEVG 


Each volume information set of fields is retrieved 
from the data set (index) catalog record. If the data set 
(index) is a unique data set (index), the volume is 
mounted. 


IGGOCLA7: IGGPVMSC 


The volume catalog record is retrieved by forming a 
44-byte true name from the volume serial number field 
in the volume information set of fields. The 44-byte 
true name for the volume catalog record is the 6-byte 
volume serial number followed by 38 zeros. 


18 IGGOCLA7: IGGPDEDD 


The volume catalog record also contains a Data Set 
Directory set of fields to describe each VSAM data set 
that is contained, partially or completely, on the 
volume. If the volume is a candidate volume for a data 
set or index, the data set or index is not described by a 
Data Set Directory set of fields. The Data Set 
Directory set of fields for a copied “‘source’”’ catalog 
describes the copied “‘source’’ catalog cluster instead 
of the data set or index. 


19 IGGOCLA7: IGGPVMSC 
20 IGGOCLA7: IGGPDEDD 


If the data set’s (index’s) space is not shared (“unique 
flag” in data set (index) attributes field on), the data 
space group set of fields described by the volume 
information set of fields (sequence number of data 
space group field) is deleted. 


21 IGGOCLA7: IGGPVMSC 


If the catalog is a recoverable catalog, the timestamp 
in the volume catalog record and format-4 DSCB in 
the volumes VTOC are not altered. 


22 IGGOCLA7: IGGPDF4T 


A new timestamp is obtained from the SYSTEM and 
the old timestamp in the volume catalog record and 
format-4 DSCB in the volume VTOC are rewritten 
with the new current timestamp. 
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23 IGGOCLAT: IGGPDUSC 


The OS/VS DADSM Scratch routines are called by 
issuing SVC 29. The extents are the data space’s 
identifier (format-1 DSCB) and extension (format-3 
DSCB) are added to a format-5 DSCB. A free VTOC 
record (format-O DSCB) is written over each of the 
data space’s format-1 and format-3 DSCBs. 


24 IGGOCLBF: IGGPSSCR 


Each entry in the list identifies one of the data set’s 
(index’s) extents in one of the data spaces on the 
volume. 


25 IGGOCLBF: IGGPSSCR 


Each of the data space’s extents is described in the 
Data Space Group set of fields. 
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Diagram EJ3. DELETE: Remove a VSAM or NonVSAM Data Set 


OS/VS Catalog Deletion of Path OS/VS Catalog 
ae: 26. Retrieve the Paths base catalog record and delete ae 
[Seal —— the association set of fields identified by the 
(| 1 ed Path’s Control Interval number. [Path | tBase 
e a 
St 


Delete CATALOG Entry Records 


27. Does the OS/VS system include the System 
Management Facility (SMF)? 
Yes 


SMF Data Set 


No 


+——se— > 28. Write SMF record number 67 for the record Type 67 


catalog record being deleted. 


29. Rewrite the catalog record into the catalog as a 
free record. 


t AIX EC) 
Base 
cst _ 


OS/VS Catalog 


32. Return to step 17 to process the index 
catalog record. 


Catalog 
Management 
Buffer 


catalog record. 


34. Return to the caller. 22224) Return Code 


35. Retrieve each Path associated with this AIX 
catalog record and do steps 26 through 30 for 
each path. 


AIX Catalog 
Record 


wy OS/VS Catalog 


Catalog 
Management TAIX 


36. Retrieve the base cluster and delete the upgrade 


ff 7 . ' «6 99 
ues TAIX Data association set of fields from the ““Y”’ catalog 
Path Catalog t AIX Index record. — 
Record tCluster Data | / 37. Delete the AIX association set of fields from the Be@e@ZZZZZZee 


/ base cluster indicated by the AIX control 


interval number, 


38. Go to step 17 to process the AIX catalog records. 


| 


C a C 


Notes for Diagram EJ3 
26 IGGOCLBS: IGGPDEPT 37 IGGOCLBS: IGGPDEAX 
Retrieve the path catalog record’s ‘‘base”’ catalog Delete the association set of fields in the base catalog 
record (the base catalog record can be either a cluster record that describes the alternate index control 
or an alternate index catalog record) and delete the interval number. This action unchains the alternate 
association set of fields in the base catalog record that index catalog record from the catalog. 
describes the path s control interval number. This 38 IGGOCLBS: IGGPDEAX 
action unchains the path catalog record from the 
catalog structure. To process the alternate index, data set, and index 


28 IGGOCLBS: IGGPDCLS catalog records, steps 17 through 34 are performed. 
See OS/VS2 System Programming Library: System 
Management Facilities (SMF) for the format of SMF 
record type 67. Record type 67 is written when a 
VSAM cluster, path, alternate index, or nonVSAM 
data set defined in a VSAM catalog is deleted. 


30 IGGOCLBS: IGGPDCLS 


The DELETE routines erase the data set’s true-name 
record and delete all references to the data set’s 
DSNAME in the catalog’s index. : 


Note: True-name records do not exist for the data set 
or index record of a copied “SOURCE” catalog. 


31 IGGOCLBS: IGGPDCLS 


If the object catalog record type is an alternate index 
or a key-sequenced cluster, steps 17 through 30 are 
performed to delete the index catalog record. 


33 IGGOCLBS: IGGPDCLS 


Steps 27 through 30 are performed for the cluster or 
alternate index catalog records. All RACF profiles 
associated with the cluster’s components are deleted 
by IGGPROBD (IGGOCLDD). 


35 IGGOCLBS: IGGPDEAX (calls IGGPDIPT 
(IGGOCLBS5)) 


When deleting an alternate index, all paths associated 
with the alternate index are implicitly deleted first. 
This process is performed by retrieving each path 
record and completing steps 26 through 30. 


If a RACF-indicated path is deleted, IGGPRPTH 
(IGGOCLDD) deletes the path’s profile. 


36 IGGOCLBS: IGGPDUPG (calls IGGPUDEL 
(IGGOCLB1)) 


The alternate index base cluster is retrieved and the 
upgrade association set of fields described by the 


d 
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alternate index’s data set (index) control interval 
numbers is deleted from the ““Y”’ catalog record 
associated with the cluster’s data set. 
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Diagram EJ4. DELETE: Remove a VSAM or NonVSAM Data Set 
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Notes for Diagram EJ4 
39 IGGOCLBS: IGGPDIAX (calls IGGPDIPT (IGGOCLBS5)) 


When deleting a cluster, all associated alternate index 
paths are implicitly deleted first, followed by all the 
associated alternate indexes and the associated cluster 
paths. 


Each alternate index record is retrieved and step 11 is 
performed to assure that the data sets (index) are not 
opened. Steps 35 through 37, 17 through 25, and 27 
through 33 are performed to implicitly delete all 
associated alternate indexes and alternate index paths. 


40 IGGOCLBG: IGGPDEL (calls IGGPDIPT (IGGOCLBS)) 


Retrieve each cluster’s associated path record and 
perform steps 26 through 30 for each path. 


41 IGGOCLBG: IGGPDEL (calls IGGPDUPG 
(IGGOCLBS5)) 


The “Y”’ catalog record associated with the cluster 


data set record and the related association set of fields 
in the data set record are deleted. 


42 IGGOCLBG: IGGPDEL (calls IGGPDCLS (IGGOCLBS5)) 


To process the cluster, data set, and index catalog 
records, steps 17 through 34 (skip step 26) are 
performed. 
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For additional information about topies related to 
DELETE processing, see: 


“Data Areas:” 


Volume catalog record description 
Data set directory set of fields description and 
format 


**Diagnostic Aids:”’ 


Catalog management return codes 
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Diagram EK1. DELETE SPACE: Release All of the Empty VSAM Data Spaces on a Volume 
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4. Release the VSAM data space and make it available 
to the OS/VS system. . 


Delete the Volume Catalog Record 


5. Does the volume catalog record contain any data 
space entries, or is the volume a candidate volume 

for an existing data set? (If FORCE option is on, 
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c 


“Mount volume [XXXXXX] 


on unit [YYY] 


Af, 
he 
© 


CPLA LOL? fp 


8. Rewrite the updated volume catalog record into EAg@2@@22Z222IZE 


VSAM data set’s volume 


Format-4 
DSCB 


Released VSAM 
data space 


OS/VS2 catalog 


Free catalog 

record 
Updated volume 
catalog record 


| vroc 


LS{ Uuoneladg Jo pouwypy 


C 


Notes for Diagram EK1 

The DELETE SPACE command enables the user to 
release all VSAM data spaces on a specified volume. This 
figure describes the processes performed by the catalog 
management services DELETE SPACE routine when the 
user issues the Access Method Services DELETE SPACE 
command in the form: 


DELETE 

(entryname/password) SPACE 
[CATALOG (catname/ password)] 
[FILE (dname)] [FORCE] 


where: 


* entryname is the volume serial number of a direct 
access volume containing VSAM data spaces to be 
deleted. 


¢ catname is the name of the catalog that contains the 
volume’s catalog record. 


* password is the catalog’s master, control interval, or 
update password. 


¢ FILE identifies the JCL statement that causes the 
volume to be mounted. 


The DELETE command parameters are described in 
OS/VS2 Access Method Services. 


1 IGGOCLBL: IGGPDELS and IGGPDLVM 


If the volume isn’t already mounted and available for 
use, the DELETE SPACE routine issues the 
appropriate mount message to the operator. 


2 IGGOCLAI: IGGPFDSP, IGGPDFMI 


FORCE DELETE uses DADSM SCRATCH to 
release all VSAM data space and make it available to 
other OS/VS system users. 


3 IGGOCLBL: IGGPDLSH, IGGPDLSD, and IGGPDLCB 


The volume catalog record contains a Data Space 
Group set of fields to describe each VSAM data space 
on the volume. 


See “Data Areas” for details about the volume catalog 
record and its Data Space Group sets of fields. 
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IGGOCLBL: IGGPDLSC 


The OS/VS DADSM Delete routine releases the 
empty nonunique VSAM data space and makes its 
space available to other OS/VS system users. 


See OS/VS2 DADSM Logic for details about deleting 
an OS/VS data set (to DADSM, the same as a VSAM 
data space). 


’ IGGOCLBL: IGGPDELS 


When the volume is totally empty, the volume catalog 
record can be deleted from the catalog. This occurs 
when there are no Data Space Group sets of fields and 
no Data Set Directory Entry sets of fields in the 
volume catalog record. 


IGGOCLBL: IGGPDLET 


IGGPDLET rewrites the record as a free catalog 
record so that it is available for future assignment. 


IGGOCLBL: IGGPDLET 


The format-4 (VTOC) DSCB is the first entry in a 
direct-access volume’s VTOC. It contains the volume’s 
owner's identification and information on how the 
volume is used. 


See OS/VS2 Data Areas for DSCB details. 
IGGOCLBL: IGGPDLET 


For additional information about topics related to 
DELETE SPACE processing, see: 


‘*Data Areas:” 


Volume catalog record description 
Data set group set of fields description and format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram EL1. DELETE CATALOG: Release an OS/VS2 Catalog 
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Notes for Diagram EL1 


The DELETE USERCATALOG command enables the 
user to release a catalog’s space and make the space 
available to other OS/VS system users. The catalog must 
be empty (see step 6 notes) or the request is rejected. This 
figure describes the processes performed by the catalog 
management services DELETE CATALOG routines 
when the user issues the DELETE command in the 
following form: 


DELETE 
(entryname/password) 
USERCATALOG [FORCE] 


where: 


° entryname is the DSNAME of the catalog to be 
deleted. 


¢ password is the user catalog’s master password. 


The DELETE command parameters are described in 
OS/VS2 Access Method Services. 


6 IGGOCLAF: IGGPDELC 


If the catalog contains more than two true-name 
catalog records, it is not empty and cannot be deleted, 
unless the FORCE option is on. 


Note: When a catalog that was copied onto another 
direct-access device (the ‘TARGET catalog) is being 
deleted, and its ‘SOURCE catalog hasn't been deleted, 
IGGPDELC allows the TARGET catalog to be 
deleted even though it isn’t empty. See the discussion 
on copying a catalog in the “Introduction”. 


8 IGGOCLAF: IGGPSDSP 


The volume catalog record contains an entry for each 
VSAM data space allocated on the volume. Each entry 
contains the data necessary to free the data space. 


Diagram EK1, DELETE SPACE, shows how each 
VSAM data space is released and it’s space made 
available to other OS/VS system users. 


9 IGGOCLAF: IGGPDELC 


The user catalog is described, as a data set, by its 
ACB. See VSAM Close Processing, in OS/VS2 VSAM 
Logic, for a description of closing a VSAM data set. 


For additional information about topics related to 
DELETE CATALOG processing, see: 


“Data Areas:” 


Volume catalog record 
Access method control block (ACB) description 
and format 


“‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram EM1. DELETE ALIAS: Remove a Non VSAM Data Set’s or User Catalog’s 
Alternate DSNAME 


OS/VS2 catalog 1. Retrieve the alias catalog record. OS/VS2 catalog 


2. Adjust the alias chain pointers in the previous 
and next alias catalog records. 


Alias 
record 


catalog 
records 


3. Delete the true-name catalog record that points 
to the alias catalog record. 


True-name 


record i Stee 
4. Delete the alias catalog record. as 
CCAPROB 


§. Return to the caller. 
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Notes for Diagram EM1 


The DELETE ALIAS command is used to remove a 
nonVSAM data set’s or user catalog’s alternate 
DSNAME. In addition, DELETE ALIAS processing 
adjusts the alias catalog record chain (previous and next 
alias record pointers in association sets of fields) to 
account for the deleted record. This diagram describes the 
processes performed by the catalog management services 
DELETE ALIAS routines when the user issues the 
DELETE command in the following form: 
DELETE 
ALIAS 
entryname 
[CATALOG (catname/password) 
CLUSTER | SPACE | USERCATALOG | 
NONVSAM | ALIAS | GDGBASE] 


where: 
¢ entryname is the name of the alias to be deleted. 


* password is the update (or higher) level password of 
the catalog containing the alias to be deleted. 


« CATALOG identifies the catalog that contains the 
record to be deleted, and specifies the catalog’s 
password. 


1 IGGOCLAS: IGGPDELX 


IGGPDELX issues the GETREC macro instruction to 
retrieve the alias catalog record. 


3 IGGOCLAS: IGGPDELX 


IGGPDELX calls IGGPCCFM (IGGOCLAS) to build 
a CTGPL and CTGFLs to update the previous and 
next record’s pointers (part of the Alias record chain) 
to the record being deleted. 
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For additional information about topics related to 
DELETE ALIAS processing, see: 


““‘Data Areas:” 


Alias catalog record 

Catalog parameter list (CTGPL) description and 
format 

Field parameter list (CTGFL) description and 
format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram EN1. DELETE GENERATION DATA GROUP: Remove a Generation Data Group 


ay Check the Generation Data Group’s Expiration Date 


1. Is the PURGE option specified by the user? 
Yes No 


2. Is the generation data group’s 
expiration date value less than the 
current timestamp value? 


Yes No 


¥ CCAPROB 


3. Return to the caller. pee=2ZZzZzea 


OS/VS2 catalog 


[=< 4. Retrieve the generation data group (GDG) base 
GDG base catalog record. 


record 


5. Have all generation data set’s in the group been 
deleted? 
Yes No 


| % CCAPROB OS/VS2 catalog 
SLL 


6. Return to the caller.<2g>| Error code | 


| True-name 
record 


7. Delete the true-name catalog record that points 
to the GDG base catalog record. 


8. Delete the GDG base catalog record. 


CCAPROB 


9. Return to the caller. 
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Notes for Diagram EN1 


The DELETE GENERATIONDATAGROUP command 
is used to remove a generation data group’s base record 
after all generaton data sets in the group have been 
deleted. This diagram describes the processes performed 
by the catalog management services DELETE 
GENERATIONDATAGROUP routines when the user 
issues the DELETE command in the following form: 


DELETE 

GENERATIONDATAGROUP (entryname) 
CATALOG (catname /password) 

(PURGE) (FORCE) 


where: 


° entryname is the name of the generation data group to 
be deleted. 


* password is the update (or higher) level password of 
the catalog containing the generation data group to be 
deleted. 


¢« catname identifies the catalog that contains the record 
to be deleted, and specifies the catalog’s password. 


1 IGGOCLBG: IGGPDEL 


If the user specified PURGE or FORCE, the 
generation data group's expiration date is ignored. See 
OS/VS2 Access Method Services for details about the 
PURGE parameter. 


2 IGGOCLBG: IGGPDEL 


If the definer of the generation data group specified an 
expiration date, the generation data group cannot be 
deleted until after that date (unless PURGE or 
FORCE is specified—see step 1). 


4 IGGOCLAS: IGGPDELB 
6 IGGOCLAS: IGGPDELB 


If all of the generation data sets in the groups haven't 
been deleted and the FORCE option is not on, 
IGGPDELB sets error return code RCDNECAT and 
returns to the caller. 


9 IGGOCLAS: IGGPDELB 


IGGPDELB issues the DELREC macro instruction to 
delete the generation data group base catalog record 
and its true-name catalog record. 
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For additional information about topies related to 
GENERATIONDATAGROUP processing, see: 


‘‘Data Areas: 


GDG Base catalog record 

True Name catalog record 

Catalog parameter list (CTGPL) description and 
format 


“Diagnostic Aids:” 


Catalog management return codes 
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Diagram E01. CONVERTV: Convert a Volume to or from Mass Storage 


NY 


1. Verify the caller’s authority to convert the volume. 


Virtual storage for the caller’s program 


=> So 2. Check the validity of the catalog parameter list and 


- the field parameter lists. New Volume 


—_——> 3. Verify that the ddname is correct and the volume 
is mounted. 


ZITA 2 


fA 
4. Indicate the volume is unusable for the duration of 


conversion. 


Convert volume infromation in the catalog that owns 
the volume 


Repeat steps 5 and 6 until all catalog entries that 
indicate the converted volume have been processed: 


Cuz 5. Retrieve a catalog record. 


6. If the catalog record points to the volume, change 
the device-type indication. 


VSAM catalog Master catalog 


7. If a user catalog is on the converted volume, change 
the pointer to the user catalog to indicate the new 
device type. 


8. Indicate the volume is usable. 


User catalog 
record 


Low-address 
range 


Format-4 DSCB 


Format-4 DSCB 
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Notes for Diagram EO1 


The CONVERTV command enables the user to convert 
the contents of a direct-access storage volume to a mass 
storage volume, or vice versa, and to have catalog 
information that indicates the old device type changed to 
indicate the new device type. 


This figure describes the processing performed by the 
catalog management services routines when the user 
issues the Access Method Services CONVERTV 
command in the form: 


CONVERTV 

FROMFILE (ddname) 

TOFILE (ddname) 

(RECATALOG (ALL VSAMCATALOG)) 
(CATALOG (catname (/password))) 


where: 


« FROMFILE and TOFILE identify the DD statements 
that cause allocation of the devices from and to which 
the volume’s contents are being converted. 


« RECATALOG indicates that a VSAM catalog owns 
the volume being converted and indicates the extent of 
recataloging that is to be done. 


« CATALOG identifies the user catalog, if there is one, 
on the volume being converted. 


CONVERTYV is described in OS/VS Mass Storage 
System (MSS) Services for Space Management. 


1 IGGOCLBZ: IGGPCONV 


Issues the TESTAUTH macro, which checks whether 
the calling program is an APF (authorized program 
function). 


2 IGGOCLBZ: IGGPVALI 

3 IGGOCLBZ: IGGPCONV 
IGGOCLBU: IGGPF4RD 
Reads the format-4 DSCB. 
IGGOCLBU: IGGPF4WR 


Writes the format-4 DSCB. If CONVERTYV fails and a 
user subsequently attempts to open a data set on the 
volume, he will receive an error code from Open. 


Before setps 5 and 6: 
IGGOCLAG: IGGPPUPC 


Writes the modified volume record. The identity of 
this record is passed to IGGOCLBZ from Access 
Method Services. 
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IGGOCLAG: IGGPRCCR 


Updates the catalog control record in the catalog that 
owns the volume to indicate the next free control 
interval. 


IGGOCLBZ: IGGPGALO 
IGGOCLAV: IGGPMOD 


Modifies device-type fields in catalog records that 
point to the volume being converted. 


IGGOCLAH: IGGPSCAT 


Searches the master catalog for the user catalog 
record. 


IGGOCLAV: IGGPMOD 


Writes the modified master catalog record that points 
to the user catalog. In step 5, IGGOCLBZ discovers 
that a user catalog is on the volume being converted 
when it finds a user catalog record that indicates the 
volume’s volume serial number. 


IGGOCLA3: IGGPRPLF 
Releases the master catalog from exclusive control. 
(See step 4.) 


PROGRAM ORGANIZATION 


Module Prologues 


This chapter discusses the implementation of the catalog management 
routines, showing how the actual modules and procedures fit together. 


The final authority of any program is the assembly or compilation listing. 
These module discussions complement the assembly listing comments, and 
assume that the listings are at hand. You should have them available for any 
in-depth analysis. 


Catalog management program listings are the key to the catalog management 
program logic. You get into the listings from the method of operation 
diagrams. Once you have located the module or routine name that interests 
you in the diagrams, you are ready to turn to the listing to find the additional 
information you require. 


Each catalog management module listing begins with a description of the 
module, called the module prologue. 


The information contained in catalog management module prologues is 
described in the topics that follow. 


Module name: The external procedure name of the module (for example, 
IGGOCLAl1). 


Descriptive name: The English name of the module (for example, Catalog 
Management: Initial Processing). 


Status: The version and release level of the module. 


Function: A brief step-by-step explanation of the functions performed by this 
module. Function is divided into steps so that you may more easily locate the 
routine responsible for each step. 


Notes: A generalized heading that includes (1) any dependencies, for 
example, CPU model or features, that will affect the operation of this module, 
(2) any restrictions that apply to this module, (3) symbols used to represent 
registers and register usage, (4) symbolic name of the maintenance area for 
this module and whether the maintenance area is used or reserved, and (5) 
any special terms and acronyms that are used within this module that are not 
necessarily used elsewhere in the documentation. 


Module type: A description of the type of this module (for example, 
procedure or macro), the name of the compiler used/required to create this 
module, the amount of storage required by this module for executable code 
and associated data, and the attributes of the module (for example, reentrant 
or read-only). 


Entry point: The name of the point at which ccatrol can enter this module, 
the conditions of entry, the calling sequence by which control was given, 
including any parameters passed and the names of modules that can enter at 
this entry point. 


Input: A description of anything this module gets or references, for example, 
registers, control blocks, and data. The means by which this module gains 
access to the input is included. 
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Output: A description of registers, control blocks, and data areas at output; 
any messages issued as a result of this module’s processing are included. 


Exit-normal: A description of conditions at and reasons for normal exit from 
this module, including the names of modules called by this module. 


Exit-error: A description of conditions at and reasons for any error exit from 
this module. 


External references: A list of modules, data areas, etc., defined outside of or 
accessible outside of this module. 


Tables: A list of all local tables and work areas, that is, data areas built and 
used only within this module. 


Macros: A description of system macros used by this module. 


Change activity: A list of any change activity to this module. 
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Module Flow Compendiums 


A compendium and its notes describe the flow of control among procedures 
and modules to perform a function. The compendium is a supplement to the 
function’s method of operation diagram. 


The compendium’s notes describe how each procedure and module contribute 
to the completion of the function, and under what circumstances the 
procedure or module is called. 


Reading Module Flow Compendiums 


Program organization compendiums are descriptions of catalog management 
functions, in terms of module (procedure) calls and usage. 


The compendium shows the flow of control among catalog management 
modules in order to perform a function. Figure 6 shows a compendium figure. 
A single-headed arrow indicates that control is passed from one module to 
another and does not return. A double-headed arrow indicates that control is 
returned when the “‘called’’ module completes its processing. 


Blocks that are indented (otherwise contained within another block) are 
called to perform a specified function and return, when finished, to the caller 
of the routine. 


Numbers and letters in bold-face type refer to descriptive notes. The notes tell 
what the caller expects the called module (procedure) to do. 


Catalog management procedures call certain procedures so frequently that, if 
each call were shown, the catalog management compendiums would be 
cluttered. For this reason, whenever a procedure calls one of these (frequently 
called) procedures, its module identifier (last two letters of the module name: 
‘xx’ in IGGOCLxx) is listed instead of drawing a separate block to show the 
procedure call. The frequently-called modules are: 


e AG: IGGOCLAG—Catalog Management Input/Output Procedures 
« AV: IGGOCLAV: IGGPMOD—Modify Catalog Field(s) 

¢ AZ: IGGOCLAZ: IGGPEXT—Extract Catalog Field(s) 

¢ BI: IGGOCLBI—Catalog Management Input/Output Procedures 

e BV: IGGOCLBV—SMF Record Processing Procedures 

¢ B3: IGGOCLB3—SMF Record Processing Procedures 
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Figure 6. Program Organization Compendium Figure 
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Figure 14 
Modify field 


data (IGGPALT2 


processing) 
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Figure 8. OS/VS2 Catalog Management Processing 
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Notes for Figure 8 


This figure describes the overall processing of OS/VS2 

Catalog Management in terms of flow-of-control between 
catalog management procedures. Detailed descriptions of 
LOCATE, UPDATE, and Catalog Management Services 


processing are on following compendiums. 


1 IGC0260U is an OS/VS2 Catalog Management module. 

2 IGGOCLAI is the OS/VS2 Catalog Management load 
module. 

3 IGGOCLC9 builds the CCA for the request and performs 
initial and final OS/VS2 Catalog Management processing. 

4 IGGPACDYV is the OS/VS2 Catalog Management 
Common Processing procedure. 

5 When the master catalog is not open, IGGPMCO is called 
to open it. 

6 IGGPMCO and IGGPMC0O2 initialize an ACB to 
describe the master catalog, then issue SVC 19 to open it. 

7 When the CTGPL indicates a Catalog Management 
Services request (DEFINE, ALTER, DELETE, or 
LISTCAT), the Catalog Management Services: Common 
Processing procedure (IGGPCDVR) is called. 

8 IGGPSCNC checks and initializes the CTGFLs for the 
other types of Catalog Management requests (LOCATE 
and UPDATE). 

9 IGGPSCAT retrieves the catalog record identified by the 


CTGPL (the object’s base catalog record). Extensions to 
the base record are retrieved as they are needed. 


BI: IGGPGET issues GET to retrieve catalog records. 


10 IGGPCKALU verifies the caller’s authorization to perform 


11 


the CTGPL’s request. 


AZ: IGGPEXT locates the password information required 
by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the object’s catalog 
record that contains its password set of fields (group 
occurrence). 


When the user is on a TSO terminal, IGGPWTSO issues 
requests to the TSO terminal for the required password. 


12 When the caller’s request is UPDATE, IGGPUPD 


receives control. The caller may request that his VSAM 
data set be extended (IGGPUPDE), that it be reset 
(IGGPRUS), or that it be updated (IGGPUPD). If the 
request is for an update, only fixed-length record fields 
should be changed. 


13 When the caller’s request is SUPERLOCATE, 


IGGPSLOC processes it. SUPERLOCATE is issued to 
obtain the volume serial number of each volume that 
contains a part of the caller-specified cluster’s data set or 
index. 


AZ: IGGPEXT locates the volume information sets of 
fields (group occurrences). 


BI: IGGPGET issues GET to retrieve catalog records as 
required. 
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14 The caller's GENDSP request is processed by either 


IGGPGDSP (request for a nonunique data space) or 
IGGPGUDS (request for a unique data space). GENDSP 
obtains the control interval numbers of the catalog 
record(s) of each object (cluster, data set, index, and 
catalog) contained in a VSAM space identified by a 
DSNAME. 


AZ: IGGPEXT locates the data space group set of fields 
(group occurrence) that describes the data space and the 
data set directory entry sets of fields that point to the 
catalog records of VSAM objects in the volume’s data 
space. 


BI: IGGPGET issues GET to retrieve volume catalog 
records as required. 


15 When the caller’s request is LOCATE, IGGPLOC 


processes it. The caller is allowed to retrieve fixed-length 
and (entire) variable-length catalog record fields. 


16 When the caller’s request is LSPACE, IGGPLSP processes 


it. 


AZ: IGGPEXT locates the data space group sets of fields 
(group occurrences) that describe each shared 
(nonunique) data space on the volume. 


BI: IGGPGET issues GET to retrieve volume catalog 
records as required. 


BV: IGGPSMFL writes SMF record type 69—VSAM 
Data Space Defined or Deleted. 
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Figure 9. LOCATE/Extract Processing 
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From another 
catalog 
management 
procedure 


2 IGGOCLAZ 
IGGPEXT 


BS 


3 IGGOCLAY 
IGGPSCNC 


4 IGGOCLAZ 
IGGPSCNF 


Notes for Figure 9 


This figure describes the processing done when a caller wants 
to retrieve a catalog record’s field. When the caller is another 
part of catalog management, the caller is allowed to retrieve 


any fixed-length or varaible-length field, or a part of a 
variable-length field. When the caller is an OS/VS 
component that issued the LOCATE command, the caller is 
allowed to retrieve only complete fixed-length and 
variable-length fields. 


1 


9 


IGGPLOC retrieves an entire (fixed-length or 
variable-length) catalog record field’s contents for the 
caller (other than an internal OS/VS2 catalog 
management procedure). 


IGGPEXT retrieves a fixed-length, variable-length, or 
part of a variable-length catalog record field’s contents for 
the caller (an OS/VS2 catalog management routine). 


If the specified field name indicates a ‘“‘derived 
information” field, IGGOCLBS processes the field name. 


IGGPSCNC initializes CTGFLs with dictionary 
information required to find the field in the catalog 
record, and ensures that the CTGFLs are valid. 


IGGPSCNF (6 through 13) processes each CTGFL 
addressed by the caller’s CTGPL to retrieve all catalog 
information that satisfies the caller’s request. 


B3: IGGPSMFG makes a copy of the base catalog record 
in case it is updated later by a modify call. 


IGGPUPGD retrieves the associated upgrade entry record 
if this is an upgrade field name. 


BA: IGGPGVAL retrieves the connecting association to 
the upgrade entry from the current base entry. 


BI: IGGPGET issues GET to retrieve connecting entries 
to the upgrade entry, as well as the upgrade entry itself. 


When the CTGFL (addressed by the caller’s CTGPL) 
addresses CTGFLs-for-tests, IGGPTSTS (6 through 10) 
processes each CTGFL-for-tests to identify each 
set-of-fields (group occurrence) that satisfies the test 
conditions. 


IGGPGVAL retrieves one catalog-record-field’s value. 


If the specified field name indicates a ‘‘derived 
information” field, IGGOCLB5 processes the field name. 


If more set-of-fields pointers (group occurrence pointers) 
are in an extension of the base catalog record, or 


If the specified set-of-fields pointer (group occurrence 
pointer) contains the control interval number of an 
extension record, IGGPGREC retrieves the required 
extension record. 


BI: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


IGGPLVAL locates the field within the catalog record. 


10 IGGPCKLLC verifies that the field exists (ie. the requested 


field is in the catalog record or one of its sets of fields 
(group occurrences)). 


; 11 IGGPTCMP compares the catalog record field’s value to 


the caller's test data and, if the compare is OK, saves the 
sequence number of the catalog record field’s set-of-fields 
pointer (group occurrence pointer). 


12 IGGPLOC72 retrieves catalog-record-field contents to 


satisfy the caller’s request. If the caller's CTGFL specifies 
a special field (one not in the catalog record) or a 
combination field-name (a field-name that identifies a 
group of related fields), IGGPLOC2 processes the 
field-name and calls IGGPGVAL, as required, to retrieve 
the requested information. 


If the caller provided CTGFLs-for-tests, each catalog 
record field is retrieved if it is: 


¢ Identified by the CTGFL’s (addressed by the CTGPL) 
field name, and 


e Contained in a set of fields (group occurrence) that 
satisfies all tests associated with the CTGFL 
(addressed by the CTGPL). The set-of-fields pointer’s 
(group occurrence pointer’s) sequence number is set by 
step 11. 


If the caller didn’t provide CTGFLs-for-tests, the contents 
of each catalog record field identified by the CTGFL’s 
field name is retrieved. 


13 IGGPGVAL retrieves each catalog-record-field’s contents, 


as required by IGGPLOC2. 


14 IGGPSHIN places the catalog record field’s contents into 


the user-provided work area addressed by CTGPL and 
increments the required work area length. If there is 
insufficient space in the work area, only the required work 
area length is changed. 


15 IGGPGREC retrieves the original base catalog record, if 


necessary, since a horizontal extension of the base or an 
associated upgrade entry record may have overlaid it. © 
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Notes for Figure 10 


This figure describes the processing done when a caller wants 
to modify a catalog record. When the caller is another part of 
catalog management, the caller is allowed to update the 
contents of a fixed-length or variable-length field, or part of a 
variable-length field. The caller (from within catalog 
management) is also allowed to delete an entire set of fields 
or add a new set of fields to the catalog reocrd. When the 
caller is an OS/VS component that issued the UPDATE 
command, the caller is allowed to update the contents of a 
fixed-length field, to request more direct-access space fora 
VSAM object—a data set or index—or to reset a VSAM data 
set. 


1 IGGPUPD modifies a fixed-length catalog record field, 
obtain more space for a VSAM object, or calls IGGPRUS 
to reset a VSAM data set. 


2 IGGPUPDE obtains more space for a VSAM object. 
3 IGGPRUS resets a VSAM data set. 


4 IGGPSFPL (5 through 13 ) processes each CTGFL 
addressed by the caller's CTGPL to modify all catalog 
record field data specified by the caller’s request. 


5 When the CTGFL (addressed by the CTGPL) addresses 
CTGFLs-for-tests, IGGPTSTS (6 through 11) processes 
each CTGFL-for-tests to identify each set of fields (group 
occurrence) that satisfies the test conditions. 


6 IGGPGVAL retrieves one catalog-record-field’s value. 


If the specified field name indicates a ‘‘derived 
information”’ field, IGGOCLBS processes the field. 


7 If more set-of-fields pointers (group occurrence pointers) 
are in an extension of the base catalog record, or 


If the specified set-of-fields pointer (group occurrence 
pointer) contains the control interval number of an 
extension record, 


IGGPGREC retrieves the required extension record. 
BI: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


8 IGGPPREC writes the contents of the buffer (a catalog 
record) prior to reading another record into it, if the 
‘“buffer-must-be-written” indicator is on. 


AG: IGGPPUPC issues PUT-Update to rewrite an 
updated catalog record. 


AG: IGGPPAD issues PUT-Add to insert a new catalog 
record into the catalog. 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMFG) as an updated record. 


Note: When the catalog record is completely updated, a 
SMF record type 63—-VSAM Data Set Cataloged — is 
written that contains the entire new catalog record (the 
base and all extensions) and each part of the original 
catalog record that was modified (part=logical catalog 
record=505-byte (or less) base or extension record’s 
contents). 


9 IGGPLVAL locates the field within the catalog record. 


10 IGGPCKLLC verifies that the field exists (that is, the 
requested field is in the record or one of its sets of fields 
(group occurrences)). 


11 IGGPTCMP compares the catalog record field’s value to 
the caller’s test data and, if the compare is OK, saves the 
sequence number of the catalog-record-field’s set-of-fields 
pointer (group occurrence pointer). 


12 IGGPXLT7? filters those field names (derived) which do 
not exist physically in the catalog. It ensures that these 
fields are not updated; all others are passed to 
IGGPALT72. 


13 IGGPALT2 replaces a catalog-record-field’s contents with 
the caller's update data. 


If the caller provided CTGFLs-for-tests, each catalog 
record field is updated if it is: 


« Identified by the CTGFL’s (addressed by the CTGPL) 
field name, and 


¢ Contained in a set of fields (group occurrence) that 
satisfies all tests associated with the CTGFL 
(addressed by the CTGPL). The set-of-fields pointer’s 
(group occurrence pointer’s) sequence number is 
available from 11. 


If the caller didn’t provide CTGFLs-for-tests, each 
set-of-field’s field identified by the CTGFL’s field name is 
updated. 


14 IGGPMOD allows an OS/VS2 catalog management 
procedure to update catalog record information in the 
following ways: 


A new set of fields (group occurrence) is added to the 
record (IGGPXDGO processing). 


A set of fields (group occurrence) is removed from the 
catalog record (IGGPXEL2 processing). 


A fixed-length field, variable-length field, or part of a 
variable-length catalog record field’s contents is modified 
(IGGPXLT2 processing). 


If the specified field name indicates a “‘derived 
information” field, IGGOCLBT processes the field name 
and update the catalog record information implied by the 
field name. 


15 IGGPSCNC initializes the CTGFLs with dictionary 
information required to find the field in the catalog 
record, and ensures that the CTGFLs are valid. 
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Notes for Figure 10 (Continued) 
16 IGGPXDGO intercepts field names (derived) which do 


17 


not exist physically in the catalog. All others are passed to 
IGGPADGO. It constructs a bit map set of fields when 
the first data space group is added and updates the 
associated data space group when data space descriptors 
are added. Note that derived field names exist only in the 
volume entry record. 


AG: IGGPAOCI obtains a control interval for 
constructing the bit map set of fields in an extension 
record. 


AG: IGGPPAD adds the newly constructed bit map 
record. 


AW: IGGPPREC updates the base volume entry record 
which points to the bit map set of fields. 


BA: IGGPGVAL retrieves the data space group 
associated with the space descriptor group to be added. 


BA: IGGPGREC retrieves the base volume entry record 
so that bit map processing can be done. 


BR: IGGPBMR updates the bit map to reflect the added 
space. 


When the caller provides set-of-fields (group occurrence) 
field data, but doesn’t provide CTGFLs-for-tests, 
IGGPADGO builds a new set-of-fields (group occurrence) 
with the caller's field data and adds it to the catalog 
record. 


18 IGGPXLT72 filters those field names (derived) which do 


not exist physically in the catalog. It ensures that these 
fields are not updated; all others are passed to 
IGGPALT2. 


19 When the caller provides header-field field data, or when 


the caller provides set of fields (group occurrence) field 
data and CTGFLs-for-tests, IGGPALT2 modifies the 
field’s contents (as per 13 above) and makes all necessary 
adjustments to the catalog records. 


20 IGGPXEL2 causes the bit map set of fields to be updated 


21 


when a data space group is to be deleted. All set-of-field 
names, both derived and nonderived, are passed to 
IGGPDEL2. 


BA: IGGPGVAL retrieves the data space group to be 
deleted. 


BA: IGGPGREC retrieves the base volume entry record 
so bit map processing can be done. 


BR: IGGPBMR updates the bit map to reflect the released 
space. 


When the caller doesn’t provide field data, IGGPDEL2 
deletes catalog record sets of fields (group occurrences). 


If the caller provides CTGFLs-for-tests, only those sets of 
fields (group occurrences) identified by IGGPTSTS (see 
10) are deleted. 


If the caller didn’t provide CTGFLs-for-tests, all sets of 
fields (group occurrences) that contain the field identified 
by the CTGFL’s (addressed by the CTGPL) field name are 
deleted. 


22 IGGPGREC retrieves the original base catalog record for 


processing the next CTGFL, since a horizontal extension 
record may have overlaid it. 


BI: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


23 IGGPPREC flushes any catalog buffers that must be 


written. 
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Figure 11. UPDATE/ Extend Processing 
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Notes for Figure 11 


This figure describes the processing done when a caller wants 7 IGGPSPAC calls OS/VS DADSM to obtain space for a 


to obtain more direct-access device space fora VSAM 
object—a data set or an index. When the VSAM object to be 
extended is in a nonunique data space, the data space 
contains two or more VSAM objects and, possibly, enough 
free space to satisfy the caller's request. When the VSAM 
object is in a unique data space, it is the only object in the 
data space and there is no free space in the data space. 


VSAM data space (EXTEND) or to create a new VSAM 
data space (ALLOCATE). 


AG: IGGPISCI ensures that a catalog or CRA extend will 
not occur while the catalog volume entry is being 
modified. 


AG: IGGPPUPC updates the base catalog volume entry 
record after the new timestamp value has been set in it. 


1 IGGPUPDE obtains more space for the VSAM object. 
BV: IGGPSMFA writes SMF record type 63—VSAM AV: IGGPMOD updates the volume catalog record fields. 
Data Set Cataloged or Altered—for the data set catalog AZ: IGGPEXT retrieves volume catalog record fields. 
Score: BU: IGGPF4DQ, IGGPF4RD, and IGGPF4WR update 
BV: IGGPSMEFL writes SMF record type 69—-VSAM the physical volume’s format-4 DSCB with new timestamp 
Data Space Defined, Extended, or Deleted—if additional values. 
i D i ito , 
space was obtained by DADSM, ss cheat anew 8 When the object is in a shared (nonunique) data space, the 
VSAM data space or to extend an existing VSAM data heoptnd ee 
sce object is allowed to reside in many data spaces (123 
Pere extents maximum per volume). 
2 IGGPINIT initializes a CTGPL and CTGFLs and calls Lee 
Note: An extent for an object in a shared data space isa 
IGGPEXT. ; 
contiguous amount of tracks in one of the data space’s 
AZ: IGGPEXT retrieves the AMDSB set of fields. extents (obtained by OS/VS DADSM). 

3 IGGPGET retrieves the base index record for IGGPCSAL attempts to obtain more space for the object 
key-sequenced data sets that have sequence set with data. from any shared data space on the volume. 

4 IGGPEXT retrieves the index AMDSB for key-sequenced 9 IGGPSALL calls IGGPSALS to attempt to obtain the 
data sets that have sequence set with data to ensure that required amount of space from the free space of one of the 
the maximum number of extents for the index component shared (nonunique) data spaces on the volume. 

WHT nOU Ds ERceeeer: Note: All of the requested amount of space can be 

5 IGGPSVOL finds the volume information set of fields obtained from more than one shared (nonunique) data 
(group occurrence) that describes the volume that space. If the amount of space necessary to satisfy the 
contains the VSAM object to be extended. request is not contiguous, IGGPSALS obtains (a 
AZ: IGGPEXT locates the volume information set of maximum of five) contiguous amounts of tracks to satisfy 

: the request. 
fields. 
&. When theob eeuis na non-shared Cuniquey data space: 10 When all shared (nonunique) data spaces on the volume 


the object is allowed to reside in only one data space (16 
extents maximum) per volume. 


If the data space exists and contains less than 12 extents, 
IGGPUALL calls IGGPSPAC to obtain another extent(s) 
for the data space. IGGPSPAC will return a maximum of 
5 extents to satisfy the request. 


If the data space already contains 12 or more extents, no 
space is allocated to the object from the specified volume. 


If the data space doesn’t exist (the volume is a candidate 
volume for the object), IGGPUALL calls IGGPSPAC to 
build a data space on the volume for the object. 


BI: IGGPGET issues GET to retrieve the volume catalog 
record. 


11 


have been examined, and none can satisfy the request, 
IGGPSPAC attempts to obtain another extent(s), at least 
large enough to satisfy the request, for any shared 
(nonunique) data space. If all shared data spaces have 12 
or more extents, IGGPSPAC builds a new data space on 
the volume (if the volume contains enough contiguous free 
space to satisfy a data space’s primary allocation 
requirements.) If IGGPCSAL called IGGPSPAC to obtain 
more space from OS/VS DADSM, IGGPCSAL calls 
IGGPSALL again to suballocate part of the newly 
obtained space to the object. 


IPPGTNXO computes the sum of the beginning CCHHs 
(converted to relative track numbers) for the newly 
acquired extents (recoverable catalogs only). 


12 IGGPTXO updates the data set directory with the new 


sum computed in 11. 


13 IGGPMVOL updates the volume information set of fields 


(group occurrence) to describe the object’s newly obtained 
space. 


AV: IGGPMOD modifies the volume information set of 
fields (group occurrence) fixed-length fields and to modify 
statistical information in the AMDSB. 
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Notes for Figure 11 (Continued) 
14 IGGPCEXT builds extent descriptors to insert in the 


volume information set of fields. The extent descriptors 
describe each contiguous amount of newly allocated 
space. IGGPCEXT computes the RBAs and CCHH values 
from the information returned by IGGPSALL: 


CCHH NN Desc# 
where: 


CCHH is the starting cylinder and track number of the 
extent, 


NN is the number of tracks in the extent, and 


Desc# is the data space descriptor’s sequence number. 


15 IGGPMEXT inserts the extent descriptors into the 


volume-information set of fields. 


AV: IGGPMOD adds the extent descriptor(s) to the 
volume information set of fields (group occurrence). 


16 When the space is obtained for a sequence-set-with-data 


object (data set or key range), IGGPSSWD allocates part 
of the newly obtained space to the object’s sequence set 
and modifies the object’s index catalog records to reflect 
this. 


IGGPGET retrieves the index catalog record. The index 
entry is then processed in a manner similar to the data 
entry except that space has already been acquired (hence, 
neither IGGPUALL nor IGGPCSAL is called). 


BV: IGGPSMEFA writes SMF record type 63—VSAM 
Data Set Cataloged or Altered—for the index catalog 
record. 
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Figure 12. Reusable Data Set Processing 
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Notes for Figure 12 


This figure describes the processing done when a caller wants 
to reset (reuse) a VSAM data set. The reusable attribute may 
be applied to a VSAM key-sequenced, entry-sequenced, or 
relative record data set and to an alternate index. The 
attribute allows the data set to have its high-used RBA set to 0 
at OPEN time. Reusable data sets may be multi-volumed and 
they must be suballocated (nonunique). Also, they cannot 
have key ranges and they are restricted to a maximum of 16 
physical extents per volume. A reusable base cluster may not 
have alternate indexes; however, reusable alternate indexes 
can be associated with a nonreusable base cluster. 


1 IGGPRUS checks the data set catalog record to verify that 
it is a type D record and that the data set has the correct 
attributes for resetting. Appropriate error codes are 
returned to the caller if data set does not have the proper 
attributes. 


2 If the data set is not reusable (but is empty), IGGPRUS 
calls IGGPLOC before returning to caller. No error codes 
are returned. 


3 If the data set can be reset, IGGPEXT retrieves the 
AMDSSB set of fields. If the data set attributes in the 
AMDSSB indicate a key-sequenced data set, the user's work 
area (CTGWKA) is checked to ensure that it contains the 
control interval number of the index record in the catalog. 
If not, return to caller with the appropriate error code. 


4 IGGPEXT retrieves each volume information set of fields 
pertaining to the data set. 


5 IGGPGET retrieves the corresponding volume records 
from the catalog. 


6 Each volume information set of fields is updated so as to 
retain only primary extents. If no primary extents remain 
after updating, the volume becomes a candidate volume. 
IGGPMOD returns the updated volume information set of 
fields to the catalog. 


7 If arecoverable catalog is involved, IGGPTNXO 
calculates for each volume processed the sum of the 
relative track addressed of extents remaining in the reset 
data set. 


8 IGGPIXO uses the value from step 7 to update the Data 
Set Directory set of fields for each volume processed. 


9 If the resetting of the data set results in extents being freed 
on the volume being processed, IGGPSSCR updates the 
Space Map set of fields. 


10 IGGPMOD updates the catalog with the AMDSB set of 
fields and the base data set catalog record. 


11 If a key-sequenced data set is being reset, IGGPGET 
retrieves the index catalog record and resetting of the 
index section of the data set proceeds as described above 
for the data component. 


12 If a key-sequenced data set has been reset, IGGPFRWK 
retrieves the data set catalog record required by 
IGGPLOC. 


13 IGGPLOC processes the user's LOCATE request. 
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Figure 13. Insert a New Set of Fields (IGGPADGO Processing) 
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Notes for Figure 13 


This figure describes the processing done when a catalog 
management routine needs to insert a new set of fields into a 
catalog record to satisfy the caller’s request. 


1 IGGPADGO inserts a new set of fields (group occurrence) 
into the object’s catalog record and adjusts other catalog 
records as required. In the notes for this figure, the 
hypothetical set of fields to be added is called ADDSET. 


Note: If ADDSET can fit in the base catalog record, its 
set-of-fields pointer (group occurrence pointer) in the base 
catalog record contains ADDSET’s displacement from the 
beginning of the base catalog record's sets of fields (group 
occurrences). 


Otherwise, ADDSET is put in an extension record and 
two set-of-fields pointers (group occurrence pointers) are 
used to locate it. Its set-of-fields pointer in the base catalog 
record contains the extension record’s control interval 
number. ADDSET’s set-of-fields pointer in the extension 
record contains its displacement from the beginning of the 
extension records sets of fields. 


2 If the base catalog record doesn’t contain an 
““available-space pointer’ (a pointer to an extension record 
that contains free space), IGGPASPT builds an 
““available-space pointer” (a set-of-fields pointer with 
sequence number = 0 and type (group) code = Q) and calls 
IGGPIGOFP to insert it into the base catalog record. 


3 IGGPAGOP ensures that there is a set-of-fields pointer 
(group occurrence pointer) in the base catalog record for 
ADDSET and determines where the set of fields can be 
inserted. If the base catalog record (or one of its 
extensions) contains a deleted set-of-fields pointer (with 
the same type code as ADDSET), IGGPAGOP activates 
it and assigns it to ADDSET. If not, IGGPAGOP builds a 
set-of-fields pointer and inserts it into the base catalog 
record (or one of its extensions). 


4 IGGPGREL identifies the set-of-fields pointer (group 
occurrence pointer) in the base catalog record (or one of 
its extensions) that has the same type code as ADDSET 
and either: 


e Is marked as deleted, or 


¢ Has the highest sequence number with ADDSET’s 
group code. 


BA: IGGPGREC retrieves any horizontal extensions of 
the base entry record. 


IGGPAGOPFP then ensures that the base catalog record 
contains a set-of-fields pointer (group occurrence pointer) 
that will point to ADDSET: 


A If IGGPGREL found a set-of-fields pointer (group 
occurrence pointer) marked deleted which points to an 
extension record: 


5 IGGPIGOP activates the set-of-fields pointer. 
IGGPAGOPFP is finished; ADDSET is to be inserted into 
the extension record pointed to by the set-of-fields pointer. 


B If ADDSET and its set-of-fields pointer (group 
occurrence pointer) can fit in the base catalog record: 


6 


IGGPIGOP builds a set-of-fields pointer for ADDSET 
and inserts it into the base catalog record following the 
set-of-fields pointer identified by IGGPGREL (see 4). 
IGGPAGOP is finished; ADDSET is to be inserted into 
the base catalog record. 


C_ If the base catalog record cannot contain a new 
set-of-fields pointer (group occurrence pointer), even if 
all sets of fields are moved out of the base catalog 
record: 


IGGPAXCI and IGGPGNEX< obtain an extension record 
for the base catalog record. 


If the record area in which the extension record is to be 
built already contains a record to be written, IGGPPREC 
flushes the record. 


IGGPASPT builds an available space pointer and inserts it 
into the base catalog record’s extension. 


IGGPIGOP builds a set-of-fields pointer for ADDSET 
and inserts it into the base catalog record’s newly obtained 
extension record. IGGPAGOP is finished; ADDSET is to 
be inserted into the base catalog record’s newly obtained 
extension. 


D If the base catalog record can contain a new 
set-of-fields pointer (group occurrence pointer) by 
moving the sets of fields (group occurrences) in the 
base catalog record into an extension record, move the 
set of fields out of the base catalog record into an 
extension record and adjust the base catalog record as 
necessary: 


10 If the base catalog record’s available-space pointer doesn’t 


11 


point to an extension record, IGGPAXCI and 
IGGPGNEX obtain an extension record to contain the 
sets of fields. 


If the base catalog record’s available-space pointer points 
to an extension record, IGGPGREC retrieves the 
extension record. 


AW: IGGPPREC writes any record in the record area that 
must be flushed before the extension record can be 
retrieved. 


BI: IGGPGET retrieves the extension record. 


B3: IGGPSMFG ensures that a copy of the original 
extension record exists. 


12 IGGPMGO moves ail sets of fields (except type codes 1 


or 2) into the extension record from the base catalog 
record. IGGPMGO adjusts each set-of-fields pointer in 
the base catalog record to point to the extension record 
containing its set of fields. 


13 If the extension record obtained by 11 isn’t able to contain 


all of the base record’s sets of fields, IGGPAXCI and 
IGGPGNEX< obtain another extension record to contain 
the remaining sets of fields. |GGPAGOP updates the base 
catalog record’s available-space pointer to point to the 
newly obtained extension record. 


14 IGGPMGO moves the rest of the base catalog record’s 


sets of fields into the extension record (obtained in 13). 
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Notes for Figure 13 (Continued) 


15 IGGPGREL re-identifies the set-of-fields pointer (group 
occurrence pointer) in the base catalog record for 
ADDSETs use. 


16 IGGPIGOP activates or builds a new set-of-fields pointer 
for ADDSET. IGGPAGOP is finished; the record into 
which ADDSET is to be inserted is the last extension 
record obtained by 11 or 13. 


If ADDSET is not to be added to the base catalog record 
and if the (deleted, now activated) set-of-fields pointer 
(see 3) points to an extension extension record: 


17 IGGPGREC retrieves the extension record into which 
ADDSET is to be inserted. (See Figure 10, 7 through 8 for 
details.) 


18 If ADDSET and its set-of-fields pointer cannot fit in the 
extension record, IGGPAXCI and IGGPGNEX obtain 
another extension reocrd. 


19 IGGPGREL determines where (in the extension record) 
ADDSET's set-of-fields pointer (group occurrence 
pointer) should be be inserted. 


If ADDSET is not to be added to the base catalog record, 
and if ADDSET's set-of-fields pointer (in the base catalog 
record) doesn’t point to an extension record: 


20 IGGPAXCI and IGGPGNEX obtain an extension record 
to contain ADDSET. 


21 IGGPIGOP builds a new set-of-fields pointer (group 
occurrence pointer) for ADDSET and inserts it into the 
extension record that will contain ADDSET. 


22 IGGPMVGO moves ADDSET into the record that is to 
contain it. 
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9 (See Figure 16) 


Field fits 


7 IGGOCLBA 
IGGPGVAL 


Figure 14. Modify Field Data (IGGPALT2 Processing) 
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Notes for Figure 14 


This figure describes the processing done when a caller needs 
to update a field in a catalog record. When the caller is an 
OS/VS component that issued the UPDATE, the caller is 
only allowed to replace the contents of a fixed-length field 
with updating data. When the caller is a catalog management 
routine, the caller is allowed to modify variable-length fields, 
which might require additional processing to accomodate a 
larger field. 


1 IGGPALT2 modifies the contents of a catalog record. It 
repeats the following sequence to process each field name 
identified by a combination name. 


2 IGGPGVAL retrieves the field to be modified. (See 
Figure 10, § through 9 for for details.) 


3. When the field is fixed-length, IGGPALT2 replaces the 
field’s contents with the caller’s update data. 


When the field is variable-length with length change, 
IGGPMVAR replaces the field’s contents with the caller’s 
update data and adjusts other catalog records as required. 


Note: IGGPMVAR can only be used with IGGPMOD callers, 
since IGGPUPD callers do not modify the contents of 
variable-length fields. 


4 When the variable-length field’s new length is less than or 
equal to its old length, IGGPSHNK: 


1. Adjusts the rest of the record so that all the record’s 
free space is contiguous, and increases the amount of 
free space. 


2. Adjusts other set-of-fields pointers (group occurrence 
pointers) to reflect displacement changes resulting 
from the free space adjustment. 


3. Replaces the catalog record field’s contents with the 
caller's update data. 


5 When the variable-length field’s new length is greater than 
its old length, and when the entire new field’s contents can 
be contained in the catalog record, IGGPEXPD: 


1. Adjusts the rest of the record so that the larger field is 
inserted, and decreases the amount of free space. 


2. Adjusts other set-of-fields pointers (group occurrence 
pointers) to reflect displacement changes resulting 
from the insertion. 


3. Replaces the catalog record field’s contents with the 
caller’s update data. 


When the entire field’s new contents cannot be contained in 
the catalog record, and that record is the base catalog record: 


6 IGGPMBGO moves the field’s set of fields (group 
occurrence) into an extension record. 


IGGPGVAL locates the field in the extension reocrd. 


8 Ifthe entire field’s new contents can be contained in the 
extension record, IGGPEXPD updates the field’s contents 
as described in 5. 


When the entire field's new contents cannot be contained in 
the catalog record; when the record is an extension record, 
and when the extension record contains two or more sets of 
fields (group occurrences): 


9 Sets of fields (group occurrences) are moved out of the 
extension record into another extension record (as 
described in Figure 16) until: 


e The entire field’s new contents can be contained in its 
set-of-fields’ extension record, or 


¢ The field’s set of fields (group occurrence) is the only 
set of fields in an extension record. 


When the entire field’s new contents cannot be contained in 
the catalog record; when the record is an extension record; 
and when the extension record contains only the field’s (to be 
updated) set of fields (group occurrence): 


10 IGGPDEIN updates the field’s contents and adjusts other 
catalog records as required. 
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Figure 10 


IGGOCLAV 
IGGPXEL2 


1 IGGOCLAV 
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2 IGGOCLAV 
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IGGOCLAX 
IGGPDGOP 


Figure 15. Remove a Set of Fields (IGGPDEL2 Processing) 
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Notes for Figure 15 


This figure describes the processing done when a catalog 
management routine needs to delete a set of fields from a 
catalog record to satisfy the caller's request. 


1 IGGPDEL2 removes a set of fields (group occurrence) 
and adjusts other catalog records as required. When 
IGGPXEL2 calls IGGPDEL2, IGGPSFPL has determined 
the sequence number of the set-of-fields pointer (group 
occurrence pointer) to be deleted. In this figure, the set of 
fields to be deleted is called DELSET. 


2 IGGPSGOP locates DELSET’s set-of-fields pointer (group 
occurrence pointer) in the base catalog record or one of its 
horizontal extensions. 


When DELSET is in the base catalog record or one of its 
horizontal extensions: 


3 IGGPDGO deletes DELSET. IGGPDEL2 marks its 
set-of-fields pointer (group occurrence pointer) as deleted 
and zeros its displacement value. DELSET is now deleted; 
IGGPDEL2? is finished and returns to IGGPSFPL. 


When DELSET is in an extension record: 


4 IGGPGREC retrieves the extension record and as many 
of its extensions as required to delete DELSET. (See 
Figure 10, 6 through 7 for details.) 


When DELSET is the only set of fields in the extension 
record: 


IGGPDEL2 marks DELSET'’s set-of-fields pointer (group 
occurrence pointer) in the base catalog record as deleted 
and zeros its pointer to the extension record. 


5 IGGPPREC updates the object’s base catalog record. 


6 IGGPPDE issues PUT-Update to rewrite the extension as 
a free catalog control interval. 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMFG) as an updated record. 


DELSET is now deleted; IGGPDEL2 processes each 
additional vertical extension that contains part of the set 
of fields (using steps 4 through 6) and, when DELSET is 
completely deleted, returns to IGGPSFPL. 


When DELSET is not the only set of fields (group 
occurrence) in the extension record: 


7 IGGPSGOP finds DELSET’s set-of-fields pointer (group 
occurrence pointer) in the extension record. 


8 IGGPDGO deletes DELSET in the extension record. 


9 IGGPDGOP deletes DELSET’s set-of-fields pointer 
(group occurrence pointer) in the extension record. 


IGGPDEL2 marks DELSET'’s set-of-fields pointer (group 
occurrence pointer) in the base catalog record as deleted, 
and zeros its pointer to the extension record. DELSET is 
now deleted; IGGPDEL2? is finished and returns to 
IGGPSFPL. 
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IGGOCLAW 

IGGPADGO 
Or 

IGGOCLAX 

1 IGGPMVAR 
or 

2 IGGPMBGO 


3 IGGOCLAG 


IGGPAXCI1 


4 IGGOCLAW 
IGGPGNEX 


5 IGGOCLAW 
IGGPPREC 
AG, B3 


6 IGGOCLBA 
IGGPGREC 
AG, B3 


5 IGGOCLAW 
IGGPPREC 
AG, B3 


7 IGGOCLAX 
IGGPMGO 


8 IGGOCLAV 
IGGPSGOP 


9 IGGOCLAW 
IGGPIGOP 


10 IGGOCLAX 
IGGPCGO 


IGGPMVAR 
or 
IGGPMBGO 
(Continued) 


IGGPMGO 
(Continued) 


11 IGGOCLAX 
IGGPDGO 


12 IGGOCLAX 
IGGPDGOP 


13 IGGOCLAG 
IGGPAXCI 


14 IGGOCLAW 
IGGPGNEX 


4 IGGOCLAW 
IGGPPREC 
AG, B3 


7 IGGOCLAX 


IGGPMGO 
(See 8 - 12) 


Figure 16. Move a Set of Fields from a Catalog Record into its Extension 
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Notes for Figure 16 


This figure describes the sequence required to move a set of 
fields (group occurrence) from one record: (OLDREC) to 
another (NEWREC). The acronyms “OLDREC” and 
““NEWREC” are introduced to help you understand this 
process; these acronyms do not appear in the catalog 
management code as symbolic names or comments. 


1 IGGPMVAR executes this sequence to move each set of 
fields (group occurrence), except the one that contains the 
expanded variable-length field, from one extension record 
to another. IGGPMVAR moves one set of fields at a time, 
the record’s last set of fields, and returns to its caller. 


2 IGGPMBGO executes this sequence.to move the 
expanding set of fields (group occurrence) in the base 
catalog record into an extension record. 


. 3. When the base catalog record’s available-space pointer 
(identified by type (group) code = 0 and sequence number 
= 0) is zero, IGGPAXCI obtains a free control interval. 


4 IGGPGNEX initializes the free control intérval‘as an . 
extension record (NEWREC). IGGPGNEX< then updates 
the available-space pointer to contain NEWREC’s control 
interval number. 


5 Ifthe “buffer must be written” indicator is on, IGGPREC 
writes the contents of the buffer (a catalog record) prior to 
reading another record into it. 


AG: IGGPPUPC rewrites an updated catalog record. 
' AG: IGGPPAD writes a new (extension) catalog record: 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMEFG) as an updated record. 


6 When the base catalog record’s available-space pointer 
points to an extension record with free space, 
IGGPGREC retrieves the extension record (NEWREC). 


AG: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


7 When there is enough free space in NEWREC to contain 
OLDREC’s set of fields (group occurrence), IGGPMGO 
moves the set of fields (group occurrence) from OLDREC 
to NEWREC. 


8 IGGPSGOP searches NEWREC to locate the position of 
the new set-of-fields’ pointer (group occurrence pointer). 


9 IGGPIGOP inserts a new set-of-fields pointer (group 
occurrence pointer) in NEWREC to contain the 
displacement of the new set of fields. 


10 IGGPCGO copies the contents of the set of fields (group 
occurrence) into NEWREC and reduces the amount of 
NEWREC's free space. 


11 IGGPDGO deletes the set of fields (group occurrence) in 
OLDREC and increases the amount of OLDREC’s free 
space. 


-12 If OLDREC is not the base catalog record, IGGPDGOP 
deletes the set-of-fields pointer (group occurrence pointer) 
in OLDREC. 


13 If the caller in step 1 or 2 determines (at 3 or 6) that 
NEWREC cannot contain the set of fields (group 
occurrence), another extension record is built. 
IGGPAXCI obtains a free control interval and 
IGGPGNEX initializes it as an extension record 
(NEWREC). The base catalog record’s available-space 
pointer is updated. 
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2 IGGOCLAZ 
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3 IGGOCLAU 
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4 IGGOCLBR 
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Figure 17. Allocating Part of a Data Space’s Space (IGGPSALS Processing) 
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Notes for Figure 17 


This figure describes the processing done when a catalog 
‘Se management routine needs to obtain an amount of 
direct-access device space from a nonunique data space (one 
that contains part or all of two or more VSAM objects) to 
satisfy the caller's request. 


1 


Cc, 


IGGPSALS assigns tracks to a VSAM object that can 
reside in a nonunique data space (a data space that can 
contain more than one VSAM object). 


IGGPEXT retrieves data space group sets of fields from 
the volume catalog record. Each data space group set of 
fields contains one or more (up to 16) extent descriptors 
that describe the data space’s extents. IGGPSALS builds a 
table that contains extent descriptors in the form: 


S#TTNN 
where 


S# is the sequence number of the extent descriptor in 
its data space group set of fields. 


TT _ is the extent’s starting track number, and is 
converted by another routine to CCHH for a seek 
address. 


NN | is the number of tracks in the extent. 


When the extent table is full, or when there are no more 
data space group sets of fields to process, IGGPSALS calls 
IGGPEDS to process each entry in the table. 


IGGPEDS scans the data space extent table to find the 
entry with the smallest TT value. This entry is processed, 
then IGGPEDS scans the table again to find the entry 
with the next higher TT value. All entries in the table are 
found, then processed, from the lowest TT value to the 
highest. 


1GGPBMkR scans the space map set of fields, starting at 
bit position TT and ending at bit position TT+NN-1, 
attempting to find a contiguous amount of unallocated 
tracks large enough to satisfy the minimum allocation unit 
for the request (usually a control interval). 


IGGPBMk returns to IGGPEDS with either a “‘no extent 
found” indicator or a TTNN value. IGGPEDS analyzes 
the TTNN value to determine: 


1. If the extent exactly satisfies the caller’s allocation 
request, no further extent table processing is done. 


2. If the extent is larger than the caller’s allocation 
request, but is smaller than any previously obtained 
extent, the (smaller) extent’s TTNN and its data space’s 
sequence number is saved. Processing the data space 
extent table continues. 


3. If the extent is smaller than the caller's allocation 
request, its TTNN and data space sequence number is 
put in the ““small extent table” if: 


e« There are fewer than the maximum number of 
entries in the small extent table (five, or a 
caller-specified maximum less than five), or 


« The extent’s NN value is larger than the smallest 
NN value in the small extent table. Processing the 
data space extent table continues. 


When the data space extent table is partially full, 
IGGPEDS processes each entry as described in 3 and 4. 


IGGPBMR adjusts the bits in the space map set of fields if 
the caller’s allocation request is satisfied with one extent. 


If the caller's allocation request is satisfied with more than 
one extent, all entries in the small extent table are sorted 
on decreasing NN value, so that space is allocated from 
the least number of extents. [|GGPBMR adjusts the bits in 
the space map set of fields for each extent required to 
exactly satisfy the caller's request. Each bit in the space 
map set of fields identifies a track on the volume as either 
allocated to a VSAM object or unallocated. 
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From ligure 8 


IGGPACDV 


1 IGGOCLAT 
IGGPCDVR 


2 1GGOCLAH 
IGGPSCAT 
BI 


IGGOCLBM 
IGGPCKAU 
AZ, Bl 


3 


4 IGGOCLB6 
IGGPWTSO 


DEFINE 
NON VSAM 


5 IGGOCLBH 
IGGPDEIA 
AG, AV 


DEFINE SPACE 


6 IGGOCLAQ 
IGGPDFFS 
Bl 


IGGOCLAL 
IGGPDTIM 


j 


8 


IGGOCLAH 
IGGPSCAT 
BI 


9 IGGOCLBM 
IGGPCKAU 
(See 3 and 4) 


10 IGGOCLBU 


{1 IGGOCLB4 


IGGPDCRA 


IGGPCDVR 
Continued 


DEFINE 
GDGBASE 


IGGOCLA4 
IGGPDEFB 


DEFINE 
ALIAS 


IGGOCLAO 
IGGPDEFX 


DEVINE 
CLUSTER. AIX, 
PATH, or CATALOG 


13.1 


IGGOCLDD 
IGGPRDEF 


14 IGGOCLAL 
IGGPDEI 
(See Figure 19) 


14.1 IGGOCLDD 
IGGPRDLC 


14.2 IGGOCLAT 
IGGPDYNA 


14.3 IGGOCLDD 
IGGPALRI 


Figure 18 (Part 1 of 2). Catalog Management Services Processing 
——— ee 
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15 IGGOCLBD 
IGGPALT 
AG.AV.AZ.BI.B3.BV 


IGGOCLBE 
IGGPALVL 
AV.AZ,BI 


17 IGGOCLBN 
IGGPVRD 
IGGPVRCV 

BI, BU 


16 


18 IGGOCLBN 
IGGPALVR 


AV.AZ.BI 


IGGOCLAR 
IGGPSALL 


IGGOCLB2 
IGGPUPG 


20 


21 IGGOCLA1 
IGGPUADD 
IGGPUDEL 


15.1 IGGOCLAT 
IGGPDYNA 


Notes for Figure 18 


This figure describes the overall processing of Catalog 
Management Services—that group of modules that allow the 
user's program to add, modify, delete, and list catalog 
information by using Access Method Services commands. 
The Access Method Services commands and their parameters 
are described in OS/VS2 Access Method Services. A detailed 
description of the flow of control for DEFINE CATALOG 
and DEFINE CLUSTER processing is on the following 
compendium. Method of Operation Diagram EAI1, Catalog 
Management Services Table of Contents, lists the Method of 
Operation Diagrams that describe Catalog Management 
Services functions. 


1 IGGPCDVR is the Catalog Management Services 
Common Processing procedure. 


2 IGGPSCAT searches the catalog for a duplicate name 
(if the request is DEFINE), or to retrieve the object's 
catalog record (if the request is ALTER, DELETE, or 
LISTCAT). If the request is DEFINE SPACE, step 3 is 
not performed. 


3 IGGPCKAU verifies the caller's authorization to 
perform the request. If the request is LISTCAT, step 4 
is bypassed. 


AZ: IGGPEXT locates the password information 
required by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the catalog’s 
cluster catalog record (control interval number 2) to 
determine if the catalog is password protected. If the 
catalog is not password protected, all security 
verification processing is bypassed. 


4 When the user is on a TSO terminal, IGGPWTSO 
issues requests to the TSO terminal for the required 
password if the password is not supplied with the input 
parameters (part of the Access Method Services job 
syntax language). 


5 When the caller’s request is DEFINE NONVSAM, 
IGGPDEFA processes it. 


AG: IGGPAOCI obtains a free control interval to 
contain the nonVSAM catalog record. 


AV: IGGPMOD inserts information into the newly 
created nonVSAM catalog record. 


BV: IGGPSMFA writes SMF record type 63—-VSAM 
Data Set Cataloged. 


6 When the caller’s request is DEFINE SPACE, 
IGGPDEFS processes it. 


AG: IGGPPAD issues PUT-Add to add records to the 
catalog as required. 


BI: IGGPGET issues GET to retrieve the volume 
catalog record. 


IGGPDTIM obtains time-of-day data. 


IGGPSCAT retrieves the the catalog record identified 
by the CTGPL (the VSAM object’s base catalog 
record). Extensions to the base catalog record are 
retrieved as they are needed. 


BI: IGGPGET issues GET to retrieve catalog records. 


9 IGGPCKAU verifies the caller’s authorization to 
create a VSAM data space. 


10 


11 


12 


13 


13.1 


14 


14.1 


14.2 


14.3 
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AZ: IGGPEXT locates the password information 
required by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the 
volume-owner’s catalog record that contains the 
password set of fields (group occurrence). (A OS/VS2 
master or user’s catalog is identified as the volume 
owner.) 


When the user is on a TSO terminal, IGGPWTSO 
issues requests to the TSO terminal for the required 
password. 


IGGOCLBU processes the format-4 DSCB, when the 
DEFINE SPACE creates the volume’s first data space: 


IGGPF4RD reads the format-4 DSCB. 


IGGPF4DQ dequeues the volume identified by the 
format-4 DSCB. 


IGGPF4WR writes (or updates, if it exists) the 
format-4 DSCB. 


IGGPDCRA defines a catalog recovery area on the 
volume when the volume’s first data space is created 
and the owning catalog is recoverable. 


IGGPDEFB builds the GDG base catalog record and 
inserts it into the catalog. 


IGGPDEFX builds the alias name catalog record. If 
the alias is the object’s first alias, IGGPDEFX adds an 
association set of fields to the object’s catalog record to 
point to the alias name catalog record. If the object has 
other aliases, IGGPDEFX modifies the previous alias 
name catalog record to point to the currently-built alias 
name catalog record. 


IGGPRDEF issues the RACDEF SVC (133) for all 
user-supplied entity names when the data set is to be 
protected by RACF. 


When the caller’s request is to create a VSAM cluster, 
path, AIX, or a user’s catalog, IGGPDEF processes it. 


IGGPRDLLC issues the RACDEF SVC (133) to delete 
the RACF indicator, if an error occurs in IGGPDEF. 


IGGPDYNA is invoked if the RACF indicator is to be 
altered in a recoverable catalog and no DD statement 
for the CRA has been supplied by the caller. This 
routine invokes dynamic allocation (SVC 99) to 
allocate the CRA volume. 


IGGPALRI is called to set or clear the RACF 
indicators. 
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IGGPCDVR 
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DELLTE 
CATALOG 


21.1 IGGOCLDD 
IGGPRFDC 


22 IGGOCLAI 
IGGPDELC 
AG, AZ, BI 


23 IGGOCLAL 
IGGPDBVC 


24 IGGOCLAH 
IGGPSC AT 
BI 


25 IGGOCLBU 


25.1 IGGOCLDD 
IGGPRDEL 


DELETE SPACE 


26 IGGOCLBL 
IGGPDELS 
AG, AV, AZ, BI 


27 IGGOCLBU 


28 IGGOCLBK 
IGGPLSP 
AZ, BI, BV 


29 


IGGOCLAI 
IGGPFDSP 


DELETE GDG BASE 


30 IGGOCLAS 
IGGPDELB 


IGGPCDVR 
Continued 


DELETE ALIAS 


31 IGGOCLAS 
IGGPDELX 


DELETE CLUSTER, 
AIX, PAGESPACE, 
PATH, or NONVSAM 


IGGOCLBG 
IGGPDEL 
AG 


33 IGGOCLBS 
IGGPDCLS 
AG, AV, AZ,BI,BV 


34 IGGOCLA7 
IGGAVMSC 
AG, AZ, BI 


32 


3S IGGOCLBF 
IGGPSSCR 


AV, AZ 


36 
IGGPBMR 


IGGOCLBU 
IGGPF4RD 
IGGPF4DQ 
IGGPF4WR 


IGGOCLB8 
IGGPDUND 


IGGOCLB! 
IGGPUDEL 


Figure 18 (Part 2 of 2). Catalog Management Services Processing 
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IGGOCLBR 


IGGPCDVR 
Continued 


IGGPDEL 
Continued 


40 


IGGOCLA3 
IGGPRPLF 


IGGOCLAS 
IGGPDALL 


IGGOCLA4 
IGGPERUG 


42.1 IGGOCLDD 
IGGPRDEL 


LISTCAT 


43 IGGOCLBQ 
IGGPLSTC 
AZ, BI 


CONVERTV 


44 IGGOCLBZ 
IGGPCONV 
BU, AG, AV, AH, A3 


C 


Notes for Figure 18 (Continued) 
15 When the caller’s request is ALTER, IGGPALT processes 


it. 


15.1 
16 


17 


18 


19 


21.1 


22 


AG: IGGPPUPC issues PUT-Update to rewrite a 
catalog record. 


AG: IGGPPAD issues PUT-Add to insert a catalog 
record into the catalog. 


AG: IGGPPDE issues PUT-Update to rewrite the 
record as a free catalog record. 


AV: IGGPMOD modifies the contents of catalog 
record fields. 


AZ: IGGPEXT locates catalog record fields. 
BI: IGGPGET issues GET to retrieve a catalog record. 


BV: IGGPSMFA writes SMF record type 63—-VSAM 
Data Set Cataloged. 


IGGPDYNA deallocates the CRA volume. 


IGGPALVL modifies volume catalog record 
information. 


AV: IGGPMOD modifies the contents of catalog 
record fields. 


AZ: IGGPEXT locates catalog record fields. 


BI: IGGPGET issues GET to retrieve the volume 
catalog record. 


IGGPVRD mounts the required volume(s) and 
IGGPVRCV removes VSAM ownership from the 
volume(s). 


BI: IGGPGET retrieves the volume catalog record. 
BU: IGGPF4RD reads the format-4 DSCB. 


BU: IGGPF4DQ dequeues the volume identified by the 
format-4 DSCB. 


BU: IGGPF4WR writes (updates) the format-4 DSCB. 
IGGPALVR updates the volume catalog record. 


AG: IGGPPUPC rewrites the updated volume catalog 
record. 


AV: IGGPMOD modifies fields in the volume catalog 
record. 


AZ: IGGPEXT locates fields in the volume catalog 
record. 


BI: IGGPGET retrieves the volume catalog record. 


IGGPSALL assigns a specified volume as a candidate 
volume to a VSAM object. 


IGGPRFDC deletes the RACF profiles for the data 
sets being deleted, if the request is to force-delete a 
RACF-indicated catalog. 


When the caller’s request is DELETE CATALOG, 
IGGPDELC processes it. 


AG: IGGPPDE issues PUT-Update to rewrite the 
record as a free catalog catalog record. 


23 


25 


25.1 
26 


27 


28 


29 


30 
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AG: IGGPCCCR checkpoints the catalog record 
before it is deleted. 


A3: IGGPRPLF dequeues the catalog (releases 
exclusive control over the catalog so that other requests 
can process its records). 


AZ: IGGPEXT locates catalog record fields. 


BI: IGGPGET issues GET to retrieve the catalog 
records. 


IGGPDBVC verifies that the caller's work area (to 
return the name of the catalog in) is in the caller's 
address space. 


IGGPSCAT searches the catalog being deleted to 
verify that the catalog is empty (contains no cataloged 
objects). 


Note: If the catalog is identified as a “target” catalog, it 
can be deleted even though it is not empty. See the 
discussion on copying a catalog in the “Introduction.” 


BI: IGGPGET issues GET to retrieve the catalog 
records that describe the catalog. 


IGGOCLBU processes the format-4 DSCB: 
IGGPF4RD reads the format-4 DSCB. 
IGGPF4WR writes the updated format-4 DSCB. 
IGGPRDEL deletes catalog RACF profile. 


When the caller's request is DELETE SPACE, 
IGGPDELS processes it. 


AG: IGGPPDEC issues PUT-Update to rewrite an 
extension record as a free catalog record. 


AV: IGGPMOD modifies the contents of the volume 
catalog record's fields. 


AZ: IGGPEXT locates a catalog record field. 


BI: IGGPGET issues GET to retrieve the volume 
catalog record. 


If the volume is completely empty, IGGOCLBU 
processes the format-4 DSCB: 


IGGPF4RD reads the format-4 DSCB. 
IGGPF4WR writes the updated format-4 DSCB. 


When the volume catalog record is not deleted, 
IGGPLSP determines the amount of available space 
there is on the volume. 


AZ: IGGPEXT locates each shared (nonunique) data 
space group set of fields (group occurrence) in the 
volume catalog record. 


BI: IGGPGET issues GET to retrieve the volume 
catalog record. 


BV: IGGPSMEL writes SMF record type 69—-VSAM 
Data Space Defined or Deleted. 


IGGPFDSP scratches all VSAM data space and makes 
it available to the OS/VS system. 


IGGPDELB deletes the GDG base catalog record. 
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31 


32 


33 


IGGPDELX deletes an alias name catalog record and 
adjusts the alias name catalog record chain. When the 
deleted alias name catalog record represents the 
object’s only alias, IGGPDELX removes the pointer to 
the alias name catalog record in the object’s catalog 
record. 


When the caller's request is DELETE CLUSTER, 
ALTERNATE INDEX, PATH, PAGESPACE, or 
NONVSAM, IGGPDEL processes it. 


AZ: IGGPEXT locates a catalog record’s field. 
BI: IGGPGET issues GET to retrieve a catalog record. 


IGGOCLBS contains the following DELETE 
procedures that are called by IGGPDEL: 


IGGPDCLS deletes data, index, cluster, and alternate 
index catalog records. 


IGGPDEAX explicitly deletes an alternate index. 


IGGPDIAX implicitly deletes one or more alternate 
indexes. 


IGGPDEPT explicitly deletes a path. 
IGGPDIPT implicitly deletes one or more paths. 
IGGPDUPG deletes upgrade association set of fields. 


Each of IGGOCLBS’s procedures call the following 
procedures as needed: 


AG: IGGPPDE issues PUT-delete to delete a catalog 
record. 


AV: IGGPMOD modifies the contents of catalog 
record fields. 


AZ: IGGPEXT locates a catalog record field. 
BI: IGGPGET issues GET to read a catalog record. 


BV: IGGPSMEFS writes SMF record type 67 to the 
SMF data set. 


IGGOCLA7 contains the following DELETE 
procedures that are called by IGGPDEL: 


IGGPVMSC deletes all space information for the 
object in the volume catalog record. 


IGGPDEMYV locates the object’s volume information 
sets of fields (group occurrences). 


IGGPDVMV ensures that all required volumes are 
mounted. 


IGGPDUSC returns the data space (issues SCRATCH 
to delete the farmat-1 identifier DSCB) from the 
volume’s VTOC. 


IGGPMCRA verifies that the primary CRA volume is 
either mounted or mountable. 


IGGPDF4T updates the format-4 DSCB and the 
volume catalog record timestamp. 


Each of IGGOCLA7’s procedures call the following 
procedures as needed: 


AG: IGGPPUPC issues PUT-Update to rewrite an 
updated catalog record. 


AV: IGGPMOD modifies the data space group set of 
fields (group occurrences). 
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AZ: IGGPEXT locates a catalog record field. 
BI: IGGPGET issues GET to read a catalog record. 


IGGPSSCR returns the space allocated to a catalog or 
cluster that is contained in a shared (nonunique) data 
space. 


AZ: IGGPEXT locates the data space group set of 
fields (group occurrence) that describes the data space. 


AV: 1GGPMOD modifies the data space group set of 
fields (group occurrence). 


IGGPGMR adjusts the space map set of fields to show 
the newly allocated tracks. 


IGGOCLBU contains the following external procedures 
used by the DELETE procedures: 


IGGPF4RD reads a format-4 DSCB from the VTOC. 
IGGPF4DQ issues the VTOC DEQ macro. 
IGGPF4WR writes the format-4 DSCB in the VTQC. 
IGGPGUND cleans up extension records. 


AG: IGGPPDEC issues PUT-Update to rewrite an 
extension record as a free catalog record. 


IGGOCLB1 contains the following external procedure 
used by DELETE procedures: 


IGGPUDEL deletes upgrade association sets of fields 
from the Y catalog record. 


IGGPUADD adds a non-upgrade alternate index to 
the upgrade set so that it can be dynamically allocated 
for CRA processing. 


IGGOCLAS3 contains the following external procedures 
used by DELETE procedures: 


IGGPRPLF releases the serialability of the catalog 
resource after performing the erase process. 


IGGPRPLM acquires the serialability of the catalog 
resource after performing the erase process. 


IGGOCLAS contains the following external procedure 
used by DELETE procedures: 


IGGPDALL deletes the ALIAS chain for nonVSAM 
catalog records. 


IGGOCLA4 contains the following external procedure 
used by DELETE procedures: 


IGGPERUG deletes the GDG association sets of fields 
for a nonVSAM catalog record. 


IGGPRDEL deletes the RACF profile of a primary 
item. 
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When the caller’s request is LISTCAT, IGGPLSTC 
processes it. IGGPCKAU is called each time a record 
is retrieved, and verifies the user’s authorization to 
retrieve the record. 


AZ: IGGPEXT locates a catalog record field. 


BI: IGGPGET issues GET to retrieve the catalog 
record. 


When the caller’s request is CONVERTV, 
IGGPCONYV processes it. 


AG: IGGPPUPC writes the catalog record. 


AG: IGGPRCCR updates the catalog control record to 
indicate the next free control interval. 


AH: IGGPSCAT searches the master catalog for the 
user catalog entry. 


AV: IGGPMOD updates device type fields in data and 
index records in the catalog. 


A3: IGGPRPLF releases the master catalog from 
exclusive control. 


BU: IGGPF4RD reads the format-4 DSCB. 
BU: IGGPF4WR writes the format-4 DSCB. 


BZ: IGGPGALO gets the catalog record whose volume 
information is to be updated. 


BZ: IGGPVALI checks the validity of the CTGPL and 
CTGFLs. 
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From Figure 18 
IGGPCDVR 


1 IGGOCLAL IGGPDSCB 
IGGPDEF Continued 
AG 


10 IGGOCLBX 
1.1 IGGOCLDD IGGPDSPC 


IGGPRDEF 


11 IGGOCLBO 
IGGPDCCO 


2 IGGOCLAN 
IGGPDSCB 
AG, AV 


12 IGGOCLBY 
IGGPDRSP 


3 IGGOCLAP 
IGGPDCDA 
AG 


13 IGGOCLAJ 
IGGPDBDI 


4 IGGOCLAS 
IGGPDEFC 
AG, AV 


14 IGGOCLAR 


5 IGGOCLAQ IGGPSALL 


IGGPDEFS 
AG 


IGGOCLAU 
IGGPSALS 
(See Figure 17) 


IGGOCLAR 
IGGPSALL 


IGGOCLAU 
IGGPSALS 
(See Figure 16) 


15 IGGOCLAQ 
IGGPDEFS 
AG, BI, B4 


16 IGGOCLAK 
IGGPDCMD 
AV, BV 


IGGOCLAE 
IGGPDCME 
AG, B3 


17 IGGOCLB8 
IGGPDFBO 


IGGOCLB4 
IGGPDCRA 


DEFINE PATH 


DEFINE CLUSTER 
or AIX 


18 IGGOCLB9 


IGGPPATH 


9 IGGOCLB9 
IGGPPAIX 
BI, BM 


19 IGGOCLAG 


IGGPAOC] 


20 IGGOCLBV 
IGGPSMFA 


Figure 19. DEFINE Processing 
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Notes for Figure 19 


This figure describes the processing done when a user's 
program issues DEFINE CATALOG to create a master or 
users catalog, DEFINE CLUSTER to create a VSAM data 
set, DEFINE AIX to create an alternate index, or DEFINE 
PATH to establish an association between a base cluster and 
one or more alternate indexes. These commands are Access 
Method Services commands, and they are described in 
OS/VS2 Access Method Services. DEFINE CATALOG is 
also described in Method of Operation Diagram EE!1, 
DEFINE CLUSTER in Diagram ED1, DEFINE AIX in 
Diagram ED3, and DEFINE PATH in Diagram EDS. 


1 IGGPDEF verifies user-provided values, propagates 
certain parameters, and generates a name for the data 
set and index of a cluster, as necessary. 


1.1 IGGPRDEF issues the RACDEF SVC (133), if the 
generated data or index name is to be 
RACF-protected. 


IGGPDSCB is a continuation of IGGPDEF. 


IGGPDCDA checks the validity of user-supplied 
parameters and determines the default value of other 
required parameters. 


4 IGGPDEFC creates an OS/VS2 user catalog. 


IGGPDEFS builds a data space. The data space is 
nonunique (contains parts of more than one VSAM 
object). 


6 IGGPSALL and IGGPSALS assigns part of the data 
space’s tracks to the catalog—a key-sequenced, 
key-range data set. 


7 IGGPDCOC builds a temporary ACB and temporarily 
opens the catalog so that the catalog’s self-describing 
records (control interval numbers 0 through 13) can be 
written. 


8 IGGPDCRA builds a catalog recovery area if the 
catalog is recoverable. 


9 IGGPPAIX checks the validity of the user-supplied 
input parameters and the password for the alternate 
index. 


10 IGGPDSPC determines the physical requirements of 
the object—its control interval size, block size, and 
number of blocks per track—based on the device that 
will contain the object. 


11 IGGPDCCO checks data and index device 
characteristics. 


12 IGGPDRSP determines the cluster’s space allocation 
quantities. 


13 IGGPDBDI partially builds the records required for 
the data set and index and obtains the primary space 
allocation for the data set and index. 


14 IGGPSALL assigns candidate volumes to the data set 
and index and, if they reside in a nonunique data space 
(contains more than one VSAM object), IGGPSALS 
allocates space from the data space. 


15 When the data set or index is to reside in a unique data 
space (contains only one VSAM object), IGGPDEFS 
obtains a unique data space for the data set or index. 


AG: IGGPISCI ensures that there is a sufficient 
number of control intervals. 
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BI: IGGPGET retrieves the volume record. 


B4: IGGPDCRA defines a catalog recovery area on the 
volume if ownership is taken by a recoverable catalog. 


IGGPDCMD completes the catalog record 
construction. 


AV: IGGPMOD modifies the contents of catalog 
record fields. 


If an error occurred during the object’s creation, 
IGGPDFBO resets any allocated tracks to an 
unallocated status and rewrites any partially built 
catalog records as free catalog records. 


IGGPPATH verifies user-supplied input parameters 
and the password for the path. 


IGGPAOCI obtains one catalog control interval to 
contain the path record. 


IGGPSMFA writes SMF record type 63 after a VSAM 
path is successfully defined. 
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Catalog Management I/O Functions 


When a catalog record is retrieved, updated (rewritten), written (added to the 
catalog), or deleted, one of the following catalog management procedures 
initiates the I/O operation: 


° IGGPGET—Retrieves the catalog record 

° IGGPPUPC— Updates (rewrites) a catalog record 
° IGGPPAD—Adds a record to the catalog 

° IGGPPDE—Deletes a catalog record 

° IGGPRAG—Retrieves a CRA record 

° IGGPRAPU—Updates a CRA record 

° IGGPRAPA—Adds a CRA record 

8 IGGPRAPD—Deletes a CRA record 


Before a new catalog record can be written into the catalog, a catalog’s 
control interval is assigned to contain the new record’s information. This 
assignment is made by: 


° IGGPAOCI—assigns more than one contiguous (if possible) control 
interval to the caller. This function is usually called during a DEFINE 
procedure. 


° IGGPAXCI—assigns one control interval to the caller. This function is 
usually called when an extension record is being built. 


The above-mentioned procedures call other catalog management I/O 
procedures to perform special functions. The other procedures include 
IGGPCCCR, IGGPISCI, IGGPRAEA, IGGPRAOP, IGGPRAOR, 
IGGPRARA, IGGPRASC, IGGPRAX, IGGPRCCR, IGGPXIO, and 
IGGPXRIO. 


This section contains a detailed explanation of the catalog management I/O 
procedures. 


all catalog and catalog recovery area I/O functions are described in Figures 
20 to 38. 


Catalog Management RACF Functions 


The procedures within module IGGOCLDC are used to check a user’s 
authorization to gain access to data sets or catalog entries, if these resources 
are protected by RACF. Authorization to use a RACF-protected entity is 
accomplished by issuing the RACHECK macro instruction. The procedures 
within module IGGOCLDD provide routines to alter the RACF indicator for 
a VSAM object and to build, alter, or delete the RACF profiles by means of 
the RACDEF macro instruction. The RACDEF and RACHECK macros are 
described in OS/VS2 MVS Resource Access Control Facility (RACF) 
General Information Manual. 


Figures 38.1 through 38.9 describe the catalog management RACF functions. 


206 OS/VS2 Catalog Management Logic 


C 


IGGPGET—catalog record retrieval 


e Retrieves the requested control interval and 


places it into the caller-specified record area. 


Initializes the RAB (one of six record area blocks 
in the CCA) and its record segment pointers. 


Normal keyed GET 


1. IGGPXIO retrieves the true name record, 
using keyed direct GET. 


2. IGGPGET converts the catalog record’s 
control interval number (in the true name 
catalog record) to an RBA. 


3. IGGPXIO retrieves the catalog record’s 
control interval, using addressed direct GET. 


Normal keyed GET-next 


— Same as “normal keyed GET’’, except that 
‘key greater than or equal’’ is specified when 
IGGPXIO retrieves the true name catalog 
record. 


Normal GET by control interval number 


1. IGGPGET converts the catalog record’s 
control interval number (specified by the 
caller) to an RBA. 


2. IGGPXIO retrieves the catalog record’s 
control interval, using addressed direct GET. 


GET requests issued while a catalog is being opened 
or created 


— When the catalog is being created, IGGPGET 
“‘retrieves” the record by locating the DEFINE 
workarea that contains the requested record. 


— When the catalog is being opened, IGGPGET 
issues EXCP and WAIT to retrieve the 
requested record. 


IGGPGET 


Read the 


Catalog 
bring 
built 
y 


true-name 
record: 
key GE 


f tGGPXIO —_s="7 
Read the 
true-name 
record: 
key equal 


Issue EXCP 
and WAIT 
to retrieve 
catalog 
record 


Convert 
control 
interval 
number to 
RBA 


Lovate the 
record in the 

DEFINE work 
area 


No GET 
for update 


9 


Figure 20. Retrieve a Catalog Record (IGGPGET) 
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IGGPPUPC—catalog record write (update) 


1. If the RPL used to retrieve the updated record 
has been reused, IGGPTRPL calls IGGPXIO to 
retrieve the catalog record again. This verifies the 
catalog record’s position in the catalog and 
re-establishes the RPL’s GET-for-update status. 


2. IGGPXIO writes the catalog record into the 
catalog, using addressed direct PUT-for-update. 
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IGGPTRPL 


Ensure that 
record status 
is complete 


Rewrite 
the 

updated 
record 


Figure 21. Write (Update) a Catalog Record (IGGPPUPC) 
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IGGPPAD—catalog record write (add) 


1. IGGPXIO retrieves the free control interval that 
will be replaced by the new record, to verify the 
control interval’s position in the catalog and to 
re-establish the RPL’s GET-for-update status. 


2. IGGPXIO writes the new catalog record into the 
catalog, using addressed direct PUT-for-update. 


3. If a true name catalog record is required, 
IGGPPAD builds it, then calls IGGPXIO to write 
it into the catalog using keyed direct PUT. 


IGGPPAD 
(IGGPP ADC) : 


| IGGPRAPA | 
ye Add record 
— tuoCRA 


GET 
et Z yr AlO 


Retrieve 
the tree 
record 


in virtual 
storage 
9 


IGGPRCCR 
Retrieve 
the 
CCR 


Set switch 
to update 


and rewrile 
the CCR 


PUT 
IGGPXIO 
Write new 


true-name 
record 


Figure 22. Write (Add) a Catalog Record (IGGPPAD) 
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IGGPPDE—catalog record deletion 


1. 


If a true name catalog record exists for the record 
being deleted: ‘ 


e IGGPXIO retrieves the true name catalog 
record, using keyed direct GET, to establish 
the record’s GET-for-update status. 


e IGGPXIO erases the true name record, using 
keyed ERASE. 


. If the catalog control record (CCR) is not already 


in a catalog management record area, 
IGGPRCCR retrieves it. 


. If the RPL used to retrieve the record (to be 


deleted) has been reused, IGGPTRPL calls 
IGGPXIO to retrieve the catalog record again to 
verify the record’s position in the catalog and to 
re-establish the RPL’s GET-for-update status. 


. IGGPPDE builds a free catalog record. Its control 


interval number is the same as the record to be 
deleted. The control interval number of the free 
catalog record is put into the catalog’s 
free-control-interval chain. 


. IGGPXIO deletes the record by replacing it with 


the free catalog record, using addressed direct 
PUT-for-update. 


. IGGPCCCR updates and rewrites the catalog 


control record (CCR). 
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record 
> 
GET 
IGGPXiO 
LRASE 
fF IGGPXIO J 


the CCR Yes 
in virtual 
erg 


Ensure that 
record status 
is get-updated 


FIGGPXIO | 


Rewrite aa 


Set switch 
to update & 
rewrite the 


Figure 23. Delete a Catalog Record (IGGPPDE) 


IGGPAOCI—assigns contiguous (if possible) 
catalog control intervals to the caller 


1. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. 


2. IGGPAOCTI assigns the requested number of 
catalog control intervals to the caller. The control 
intervals will be used to contain new catalog 
records (built during a DEFINE process). One of 
the following methods is used (in the order listed) 
to obtain the control intervals: 


A. If enough previously unassigned control 
intervals are available in the catalog’s extent, 
IGGPANCI preformats and assigns the 
requested number of control intervals to the 
caller. 


B. If enough free control intervals (not necessarily 
contiguous) are available, IGGPAOCI removes 
the requested number of control intervals from 
the free control interval chain and assigns them 
to the caller. 


C.IGGPANCI obtains more space via catalog 
extend for the catalog, then preformats and 
assigns the requested number of control 
intervals to the caller. 


3. IGGPCCCR updates and rewrites the catalog 
control record (CCR). 


IGGPAOCI 


IGGPRCCR 


Retrieve 
the CCR 


IGGPNIO 


Assign the 
tree Cls 
to the 
caller 


Pretormat 
and assign 
the Cls to 
the caller 


Figure 24. Assign Catalog Control Intervals to the Caller 
(IGGPAOCI) 
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IGGPAXCI—assigns one catalog control Pieiaes 
interval to be used as an extension record a 


1. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. 


2. IGGPAXCI assigns one control interval to the 
caller. One of the following methods is used (in 
the order listed) to obtain the control interval: 


in virtual 
storage 
? 


A. If a free control interval is available, 
IGGPAXCI removes it from the free control 
interval chain and assigns it to the caller. 


|___IGGPRCCR___ 
Retrieve 
B. IGGPANCI preformats and assigns a 


previously unassigned control interval to the 
caller. This might mean that IGGPANCI first 
obtains more space for the catalog, via catalog 


extend. ee 
3. IGGPCCCR updates and rewrites the catalog 


control record (CCR). 


Preformat and 
assign a Cl 
to the caller 


IGGPXIO 


Assign 
free Cl to 
the caller 


IGGPCCCR 


Update and 
rewrite the 
CCR 


Figure 25. Assign a Catalog Control Interval for an 
Extension Record (IGGPAXCI) 
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IGGPCCCR—updates and rewrites the 
catalog control record (CCR) IGGPCCCR 


1. The CCR is read to establish its set-for-update 
status. 


2. IGGPCCCR updates the CCR control fields to 
reflect the current catalog record usage. 


3. IGGPCCCR calls IGGPXIO to rewrite the CCR, 
using addressed PUT-for-update. 


Update 

RBA and 
control fields 
in the CCR 


IGGPXIO IKGGPRCCR 


Rewrite 
the updated 


Reset the 
Retrieve the 


catalog 
control 
record 


switch 


Figure 26. Update and Rewrite the CCR (IGGPCCCR) 
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IGGPRCCR—reads the Catalog Control 
Record (CCR) and updates control fields 


and RBAs from information contained i 
within the CCR Ceny 


IGGPXIO 


Retrieve 
the CCR 


Move CCR 
control fields 
to CAXWA 


Merge CCR 
RBAs to 
ARDBs 


Indicate 
that CCR 
was read 


Figure 27. Read the CCR and Update Control Fields and 
RBAs (IGGPRCCR) 
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IGGPXIO—calls VSAM record management 
1. IGGPXIO initializes an RPL. 


2. IGGPXIO issues GET, PUT, or ERASE—a 
VSAM record management request macro 
instruction. 


oe) 


. If an error occurs, IGGPXIO exits on error to 
IGGPIORA to convert the RPL error code to an 
appropriate catalog management error code. 
IGGPIORA then returns to the routine that called 
the catalog I/O function that was processing 
when the error occurred. 


IGGPXIO 


IGGPIORA 
= cr 
request“ 
Translate the 
pase revord mgmt. 


error vode to 
a catalog mgmt, 
error vode 


No: 


|__IGGPEMIO. _| 


Write an 


error message 
to the operator 


IGGPIORA 

Error Yes 
detected Analyze the 
return code 


No 


Figure 28. Call VSAM Record Management for Catalog Request (IGGPXIO) 
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IGGPISCI—ensures that there are enough 
free control intervals, so that the catalog 
won’t be extended (obtain more space) at the 
same time a volume catalog record is being 
processed 


1. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. 


2. If there are not sufficient free control intervals 
available, IGGPISCI calls IGGPANCI to obtain 
more space (via catalog extend) for the catalog. 
IGGPANCI then preformats and assigns a 
previously unassigned control interval to 
IGGPISCI. 


3. IGGPXIO retrieves the control interval to 
establish its GET-for-update status, using 
addressed GET-for-update. 


4. IGGPXIO rewrites the control interval as a free 
control interval, using addressed PUT-update. 


5. IGGPCCCR updates and rewrites the catalog 
control record (CCR). 
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IGGPISCI 


Entry 


virtual 
storage 
” 


IGGPRCCR. 


Retrieve 
the CCR 


Ok 


ey 


Not 
enough 


IGGPANCI 


l-orces 
catalog 
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GET 
Retrieve 
the 
assigned 
record 


PUT 


IGGPXIO 


Rewrite 
asa Tree 
Cl 


LGGPCCCR 


Update and 
rewrite the 
CCR 


Figure 29. Ensure Availability of Catalog Control Intervals 
(IGGPISCI) 


Recoverable No 
catalog 


, 


IGGPRASC 


Lnsure that 
sufficient Cls 
are available 


CRA 
uvtended 
a] 


Get the 
volume entry 
trom catalog 
ESI 


IGGPRAPU—CRA record write (update) 


CRA No 
record 
9) 


Set switch 
to bypass 

catalog's 
1/0 


IGGPRAOR 


Orient to 
CRA 


IGGPRAPV 


Update Vol 
timestamps 
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Figure 30. Write (Update) a CRA Record (IGGPRAPU) 
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IGGPRAPA—CRA record write (add) 


IGGPRAPA 


IGGPRAPC 


volume No Add record 
determined to buffer 
2 chain 
Yes 
IGGPRAOR IGGPRAX 
Orient Clean up 
toCRA und exil 


| IGGPRAPV | 


timestamps 
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to be updated inne 
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volume 
timestamps 


IGGPRARA 
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and write 
record to CRA 


Buffered 
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exist 
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Write 
record to 
catalog 


IGGPRARA 
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No 


IGGPRAX 


Clean up 
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Figure 31. Write (Add) a CRA Record (IGGPRAPA) 
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IGGPRAPD—CRA record delete 


IGGPRAPD 
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Read 

of CCR 

required 
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IGGPRAOR 


Orient to 
CRA 
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free 
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Figure 32. Delete a CRA Record (IGGPRAPD) 
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IGGPRAOR—orient to CRA 
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IGGPRAOR 


RPL Yes Assign 
needed an 
9 RPL 
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CRA 
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Search CAXWA 
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open 
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Figure 33. Orient to the CRA (IGGPRAOR) 


IGGPRAOP—CRA OPEN 


IGGPRAOP 
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from CRA 
CAXWA chain 


CLOSE 
required 
? 


TRA SVC 20 
on.cat: ues Close the 
vol: CRA 
Indicate that 
volume DDname & 
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Figure 34. Open a CRA (IGGPRAOP) 
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IGGPRARA—assign control interval 


numbers to new CRA records and write them IGGPRARA 
othe CRA © ) 


End 

of extent 
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EXTEND ” 
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remaining Cls 
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Place CRA creation 
timestamp and 
release ID into 
record 
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Figure 35. Assign Control Interval Numbers to CRA Records 


(IGGPRARA) ) 
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IGGPRASC—ensures that there are enough 
free control intervals in a CRA so that the 
CRA won't be extended at the same time the 
CRA’s volume catalog record is being 
extended 


IGGPRAOR 


Orient to 
CRA 


Indicate a 
FORCE EXTEND 
operalion 


IGGPRARA 


Extend the 
CRA 


Figure 36. Ensure Availability of CRA Control Intervals 


(IGGPRASC) 
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IGGPRAX—CRA I/O function exit routine 


IGGPRAX 


IGGPRACC 


CRA 
CCR CHKPT >" Write the 
re ¢: CRACCR 


Decreminent UCB 
and CAXWA use 
counts and 
indicate CRA is 
inactive 


To catalog I/O To the caller of 

function that called the catalog /O, 

aCRA I/O function function that 
called CRA I/O 
function 


Figure 37. Return from CRA I/O Function (IGGPRAX) 
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IGGPXRIO—calls VSAM record 


a management 


1. IGGPXRIO initializes an RPL. 


2. IGGPXRIO issues GET or PUT—a VSAM 
record management request macro instruction. 


3. If an error occurs, [GGPXRIO returns on error to 
IGGPRAEA to convert the RPL error code to an 
appropriate catalog management error code. 


IGGPXRIO 


IGGPRAEA 


C 


Translate the rec. 
mgt. error code to 
a cat. mgt. error 

code 


Issue 
GET 
request 


Record 
retrieval 


Issue 
PUT 
request 


Invalid 


IGGPRAEA 


Analyze 
return code 


Yes 


Error 
detected 


Figure 38. Call VSAM Record Management for CRA Request (IGGPXRIO) 


Yes 


RBA 
CRA 
1/O error 


IGGPEMIO 


Write error 
message to 
operator 
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IGGPALRI—Alter RACF Indicator 


IGGPALRI is invoked by IGGOCLAT before 
regular alter processing, if CTGFVRON or 
CTGFVROF is on. 


1. Use TESTAUTH to ensure that the caller is 
authorized (state, key, or APF). 


2. Set or clear the RACF indicator in the catalog 
entry according to CTGFVRON and 
CTGFVROF. 


3. If a catalog is being altered, set or reset the 
CAXRAC bit according to CTGFVRON and 
CTGFVROF. 
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Is 
caller 
authorized 


No 
Exit 


Clear RACF 
indicator in 
catalog entry 


Set RACF 
indicator in 
catalog entry 


Alter No 
catalog 


Set or reset 
CAXRAC 


Figure 38.1 Alter RACF Indicator (IGGPALRI) 
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IGGPALRN—Alter Rename 
IGGPALRN is called by IGGOCLBD during alter 
rename processing. 
1. The data set type (RCDID) must be C,D,G,lI, or 

R. 
2. If CNAME (the entry name of the catalog record aC DID No 

in the current record area) equals the name valid 

pointed to by CTGFVENT, the initial rename 

should be done. CTGFVENT points to the old Nee 

name and CTGNEWNM points to the new name. 

Set up 

3. If CNAME does not equal the name pointed to RACDEF 


parameters 


by CTGFVENT, then this is a back-out request. 
CTGNEWNM points to the “‘old’”’ name and 
CTGFVENT points to the ‘“‘new”’ name. 


Issue 


RACDEF 
NEWNAME 


Set return 
code 114 


Set return Other 
code 110 error 


Figure 38.2. RACF Alter Rename (IGGPALRN) 
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IGGPRDEF—RACF Define 


IGGPRDEF is called by IGGOCLAT before 
defining a VSAM data set or catalog. It is also called 
by IGGOCLAL after generating a data or index 
name. In both cases, this routine is not called, if both 
JSCBADSP and CTGFVRON are off. The address 
of the FVT is passed in CMSWARF'V. 


1. If the primary object being defined is a cluster or 
alternate index, do RACF-define processing for 
user-supplied data and index names as well as the 
primary object name, unless the object is a 
catalog or path (CTGTYPE is M,U, or R). 


2. If a catalog is being defined, the volume serial for 
the RACDEF should come from the FVT’s 
volume list rather than from the CAXWA/UCB. 


3. If RACDEF fails because definition of the data 
set is not allowed by the security subsystem, then 
exit with return code 118 and set the reason code 
according to the object being processed at the 
time. 


4. If RACDEF fails for other reasons, exit with 
return code 114. 


5. Save the primary and component names in 
CMSROBJN (in the CMS work area) as they are 
RACF-defined. 
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IGGPRACD 
Generated Yes 
name Issue 
RACDEF 
No 
» 
Issue RACDEF 
for primary 
object 
Catalog Yes 
or Exit 
path 


No 


IGGPRACD 
Issue RACDEF J 


for data object 


<-> ; 
Exit 


Yes 
IGGPRACD 
Issue RACDEF 
for index object 


Figure 38.3 RACF Define (IGGPRDEF) 


IGGPRDLC—RACTF Delete of a 
Partially-Defined Cluster 


IGGPRDLLC is called by IGGOCLAT after a define 
of a VSAM RACF-protected data set has failed. The 
routine is called for every RACF-indicated object 
name associated with the failing define. 


1. The primary and component names (if any) are 
found in the CMSROBIJN array (in the CMS 
work area). For a catalog (CTGTYPE is M or UV), 
the data and index names are not defined to 
RACE. Also for a catalog, the volume serial for 
the RACDEF is from the FVT’s volume list. 


Yes 


No 


IGGRPDEL 


Delete cluster 
or AIX profiles 


All 
elements 
deleted 


Yes 
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IGGPRDEL 


Delete the 
catalog profile 


Figure 38.4 RACF Delete of a Partially-Defined Cluster 


(IGGPRDLC) 
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IGGPRFDC—RACF Force Delete Catalog 


IGGPREDC is called by IGGOCLAT before a force sa j 
delete of a catalog. ntry 


1. IGGPGALO (in IGGOCLBZ) reads each entry in 
the catalog except the first. When the low-key 
range is exhausted, clear the end-of-data See 
condition out of CCAPROB. search at CI 10 


2. If the data set described in the entry is 
RACF-protected, call IGGPRDEL to delete the 
profile. 


IGGPGALO 


Read a catalog 
entry 


RACF- 
indicated 


IGGPRDEL 
Delete 7} 
profile ) 


Increment CI 
to next entry 


All 
entries 
processed 


Exit 


No 


Clear ‘not 
found’ return 


code set by 
IGGPGALO 


Figure 38.5 RACF Force Delete Catalog (IGGPRFDC) J 
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IGGPRACT—RACF Catalog Verification 


IGGPRACT is called by IGGPPWVR (in 
IGGOCLBM). 


1. The catalog entries for items that have implicit 
protection are GDG base, nonVSAM, user 
catalog connector, or alias. 


2. Global verification indicates that RACF 
authorization checking is being done through a 
secondary source because the primary source is 
not RACF-protected or RACF authorization 


could not be obtained through the primary source. 


3. LISTCAT and locate can be performed with read 
authorization by suppressing passwords. 
Two-level checking indicates that, if alter fails, 
the saved level will then be tried. 


Page of SY26-3826-3 
Added July 28, 1978 
By TNL SN26-0912 


Indicate 
passwords to 
be checked 


Catalog 
RACF- 
protected 


Already 
checked 


ae 


Indicate 
alter level 


LISTCAT 
or 
locate 


Indicate 


Save original 
level and 
indicate alter 


catalog 
request 


IGGPRACK 


Check 


Indicate 
2-level 


checking authorization 


Figure 38.6 RACF Catalog Verification (IGGPRACT) 
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IGGPRACG—RACHECK for Implicit Alter 
GDG 


IGGPRACG is called by IGGOCLA4 to check 
authorization to alter the GDG base when defining a 
GDG generation. 


1. Before this routine is called, DEFINE processing 
will have determined that the user has RACF 
update authorization to the catalog. 


¢ 


226.6 OS/VS2 Catalog Management Logic 


Entry 


Set level 


to update 


IGGPRACK 


RACHECK on 
GDG base 


RACF- 
protected 


Yes ; 
Authorized Exit 


IGGPRACK 


RACHECK 
on catalog 


Yes 
No 


Yes a 
Authorized Exit 


Set return 


and reason 
codes to 56-14 


Figure 38.7 RACHECK for Implicit Alter GDG 
(IGGPRACG) 


Page of SY26-3826-3 
Added July 28, 1978 
By TNL SN26-0912 


IGGPRACV—RACF Verification Routine 

IGGPRACYV is called by IGGPPWVR (in 
IGGOCLBM) in its initial authorization attempt. If 

authorization is not obtained by calling this 


procedure, IGGPPWVR attempts authorization 
through a global entity. 


1. The catalog entries for items that can have 
implicit protection cannot be RACF-protected or 
contain passwords. These items are GDG base, 
nonVSAM, user catalog connector, or alias. This 
routine is not called for GDG base authorization 
checking when a GDG generation member is 
being defined. See IGGPRACG. 


2. If 2-level authorization checking is specified, 
IGGPRACK first tries alter authorization. If that 
fails, IGGPRACK issues a RACHECK for the 


saved level. 


Indicate 
passwords to 
be checked 


RACF- 
protected 


Implicit but 
not alter 
nonVSAM 


LISTCAT 
or 
locate 


Indicate 
2-level 
checking 


Alter 


authorization 
needed 


<-> 
Yes 


IGGPRACX 


Get the 


true name 


IGGPRACK 


Check 


authorization 


Figure 38.8 RACF Verification Routine (IGGPRACV) 
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IGGPRACK—RACF Check Routine 


IGGPRACK issues RACHECK SVC (130) to 
determine whether user has RACF authorization. 


Parameters passed when IGGPRACK issues 
RACHECK are the dsname, volser, authorization 
level, logging option, and the profile option. Except 
for a user catalog connector and a nonVSAM entry, 
the volser is that of the volume containing the 
catalog entry. For a nonVSAM entry, the volser is 
that of the first volume containing the data set. For a 
user catalog connector entry, the volser of the 
volume pointed to by the user catalog connector is 
used. This is extracted from the volume group 
occurrence field. 


1. 


If the request is for a global entity (CKAUGLOB 
is on) then set up to request LOG=NOFAIL, 
which indicates that authorization failures will not 
be logged. 


. Issue RACHECK with the authorization level 


indicated by CKAURACL. 


. If the RACHECK succeeded, set CKAUVEFST to 


indicate verification should stop unless 
CKAUDOUB is on and CKAURACL is at the 
non-master level, in which case set CKAUVFRD. 
If it was the master level that was verified, set 
CKAUVFMT. 


. If the RACHECK indicates the entity is not 


defined, indicate by setting CCAPROB non-zero; 
otherwise, set CCAPROB to zero. 


. If RACHECK failed and CKAUDOUB is on 


(indicating a double RACHECK is in order), set 
CKAURACL to the original authorization level 
and loop back to reissue the RACHECK, unless 
CKAUVERD is set, in which case exit. If 
CKAURACL is at the read level, the two-pass 
loop will be exited. 
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Global No 
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> 
set iaaieate 
LOG=NOFAIL a 
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Checking a 
catalog 


Issue 
RACHECK 


Profile 
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Set-up to use 
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Resource 
defined 


No ; 
Exit 
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authorized 
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Figure 38.9 RACF Check Routine (IGGPRACK) 


C 


Program Organization 226.9 


C 


DIRECTORY 


The directory section contains lists of items and cross-reference information 
related to each item in the list. The lists include: 


e Module Directory 
e Module Packaging 


e External Procedure Directory 


e Procedure Calls Directory 


e Procedure Called-By Directory 


Module Directory 


Module 
Name 


IDACAT11 
IDACAT12 


IDACAT13 
IFGO191X 
IFGO191Y 
IFG0200N 


IGC0002F 
IGGOCLAA 
IGGOCLAB 


IGGOCLAC 
IGGOCLAD 


IGGOCLAE 


IGGOCLAF 


The module directory is organized alphabetically by symbolic module name. It 
lists the descriptive name, the module’s procedure names (external entry 
points), and the method of operation diagrams and program organization 


Descriptive 
Name 


Private (User's) Catalog Open 


Private (User's) Catalog Close 


Private Catalog Task Termination 
Catalog Open ACB Processor, Load 1 
Catalog Open ACB Processor, Load 2 
VSAM Close/EOV ACB Processor 


OS/VS Catalog Management 
SUPERLOCATE: Upgrade Support 


Catalog management driver 


Open the master catalog 


Open the master catalog (part 2) and the 


catalog recovery area 


DEFINE CATALOG processing: 
Open and build 


DELETE CATALOG processing 


External 
Procedure 
Names 


IDACAT11 
IDACAT12 


IDACAT13 
IFGO191X 
IFGOI9LY 


IFG0200N 
IFGO5S0Y 


IGC0002F 
IGGPSLEN 
IGGPACDV 


IGGPMCO 


IGGPMCO2 
IGGPRAOP 


IGGPDCME 
IGGPMEBM 


IGGPDELC 
IGGPEMIO 
IGGPEMSG 


figures in which that module is referenced. 


Method of 
Operation 
Diagrams 
BB1 


AAI, CA1, DB1 
DG2, DG3, DG4 


DB1, DD1, DEI, 
DH1 


EE2 


EB1, EL1 
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Module Directory (continued) 


Module 
Name 


IGGOCLAG 


| IGGOCLAH 


IGGOCLAI 
IGGOCLAJ 
IGGOCLAK 
IGGOCLAL 


IGGOCLAM 


IGGOCLAN 


IGGOCLAO 
IGGOCLAP 
IGGOCLAQ 


IGGOCLAR 
IGGOCLAS 


IGGOCLAT 


IGGOCLAU 
IGGOCLAV 


Descriptive 
Name 


Catalog I/O Subfunctions 


Search the catalog 


DELETE SPACE: Force Support 


DEFINE processing: Build data and index 
catalog records 


DEFINE processing: Catalog record 
completion 
DEFINE processing: 1st module 


SUPER-LOCATE processing 


DEFINE processing: 2nd module 


DEFINE ALIAS Processing 
DEFINE processing: 3rd module 
DEFINE SPACE processing 


Suballocate: Assign candidate volumes 


DEFINE CATALOG processing 


Catalog Management Services Common 
Processing 


Suballocate: Obtain space 


Modify a catalog record’s field 
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External 
Procedure 
Names 


IGGPANCI 
IGGPAOCI 
IGGPAXCI 
IGGPCCCR 
IGGPCPLR 
IGGPIORA 
IGGPISCI 
IGGPPAD 
IGGPPADC 
IGGPPDE 
IGGPPDEC 
IGGPPUPC 
IGGPRCCR 
IGGPWFLR 
IGGPXIO 


IGGPCSDO 
IGGPQNQC 
IGGPSCAT 
IGGPSC2 


IGGPDFM1 
IGGPFDSP 


IGGPDBDI 


IGGPDCMB 


IGGPDEF 
IGGPDTIM 


IGGPDBVC 
IGGPSLEL 
IGGPSLOC 


IGGPDCCE 
IGGPDRDA 
IGGPDSCB 
IGGPPSEM 


IGGPDEFX 
IGGPDCDA 
IGGPDEFS 


IGGPSALL 


IGGPDCRC 
IGGPDEFC 


IGGPARFS 
IGGPCDVR 


IGGPSALS 


IGGPDEL2 
IGGPMOD 


IGGPSGOP 
IGGPUPD 


Method of 
Operation 


DB1, DC1, EG1 
BB1, DC1, DC2, 
DC3 


EK1 


DG5 
DG2, DG3 
DB1, DG1 


ED1, EE] 
EC1, ED1, ED3 
EC! 


— 


EF2 
EC1, EE1 


ED1, ED3, EE]1, 
EG1, EG2 


DI, DJ1, ED1, 
ED3, EE1, EH3 


EC1, EE1 


DB1, DD1, EB1, 
EC1 


DJ2 


DM3 
DM1, DM3, EH3 


DB1, DH1, DI3 


Program 
Organization 


Figures 

10, 18, 19, 24 
13, 16, 18, 25 
26 

11, 16, 19, 29 
10, 18, 22 
15, 18, 23 

11, 16, 18, 21 
18, 27 


28 


19 


18, 19, 38.3 
18 


18 


oo 


19 
18, 19 


11, 18, 19 


19 


8, 18, 38.1, 
38.3, 38.4, 38.5 


11, 17, 19 


10, 15 

10, 11, 12, 
16, 18, 19 
15, 16 

8, 10 
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Module Directory (continued) 
External Method of Program 
Module Descriptive Procedure Operation Organization 
Name Name Names Diagrams Figures 
IGGOCLAW Add a group occurrence (set of fields) IGGPADGO DMI! 10, 13 
to a catalog record 
IGGPGNEX — 13, 16 
IGGPGREL — 13 
IGGPIGOP DMI 13, 16 
IGGPPREC DH1 10, 13, 15 
IGGOCLAX Modify a catalog record’s field (part 2) IGGPALT2 DH1, DM2 10, 14 
IGGPDGO — 15, 16 
IGGPDGOP — 15, 16 
IGGPEXPD DM2 14 
IGGPMGO — 13, 14, 16 
IGGPSHNK DM2 14 
IGGOCLAY Validate the caller's CTGPL IGGPSCNC DB1, DE1, DM1 8,9, 10 
IGGOCLAZ Extract a catalog record’s field IGGPEXT DE]1, DE2, DJ2 11, 12, 16, 
17, 18 
IGGPLOC DB1, DE1, DE2 8,9, 12 
IGGOCLAO Show Catalog Processing IGGOCLAO EI2 — 
IGGOCLAI1 Catalog first load IGGOCLAI1 AAI1, CA1, DB1 8, 18 
IGGOCLA2 Generic LOCATE, Locate GDG Base IGGPGDGL DG6 — 
IGGPGLOC DG5 — 
IGGOCLA3 | Search the catalog (part 2) IGGPCSCP — — 
IGGPCVX — = 
IGGPDOG — — 
IGGPGPCC — — 
IGGPGRE DC1, DC3, DC4 — 
IGGPRPLF DC4, EO! 18 
IGGPRPLM DC4 18 
IGGOCLA4 DEFINE GDGBASE Processing IGGPDEFB EB1, EF3 18, 38.7 
DEFINE ALIAS Processing IGGPDGDS — — 
IGGPERUG — 18 
IGGOCLAS DELETE GDGBASE Processing IGGPDALL — 18 
IGGPDELB EB1, EN1 18 
DELETE ALIAS Processing IGGPDELX EB1, EM1 18 
IGGOCLA6 DEFINE SPACE: Build the Data Space IGGPBJFB EGI — 
Group and Data Set Directory Entry sets of IGGPCBPT — — 
fields IGGPCRTC EGI — 
IGGPDFS2 — — 
IGGOCLA7 DELETE processing IGGPDEMV — 18 
IGGPDF4T EJ2 18 
IGGPDUSC EJ2 18 
IGGPDVMV — 18 
IGGPMCRA — 18 
IGGPVMSC EJ2 18 
IGGOCLA8 DEFINE processing IGGPDFRS ED2, ED4 — 
IGGOCLA9 Catalog Recovery Module IGGPCCBC — — 
IGGPCMRR — — 
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Module Directory (continued) 


Module 
Name 


IGGOCLBA 


IGGOCLBB 
IGGOCLBC 


IGGOCLBD 


IGGOCLBE 


IGGOCLBF 
IGGOCLBG 


IGGOCLBH 


IGGOCLBI 


IGGOCLBJ 
IGGOCLBK 


IGGOCLBL 


IGGOCLBM 


IGGOCLBN 


IGGOCLBO 


Descriptive 
Name 


Extract a catalog record’s fields (part 2) 


UPDATE-Extend processing 
UPDATE-Extend initialization 


ALTER processing 


ALTER: Volume processing 


Subscratch: Return space 


DELETE Processing 


DEFINE NonVSAM Processing 


Catalog GET and recovery subfunction 


GENDSP Processing 
LSPACE Processing 


DELETE SPACE Processing 


Check the caller's authorization to 
access catalog information 


ALTER: Remove volume information 


CRA I/O subfunctions 
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External 
Procedure 
Names 


IGGPGREC 
IGGPGVAL 


IGGPTSTS 
IGGPUPDE 


IGGPINIT 
IGGPSVOL 


IGGPALT 


IGGPALEC 
IGGPALVL 
IGGPANVV 


IGGPSSCR 


IGGPDEL 

IGGPDEXA 
IGGPDLXT 
IGGPDOPN 


IGGPDAVO 
IGGPDEFA 


IGGPGET 


IGGPGETC 
IGGPTNXO 
IGGPTXO 
IGGPUCRS 


IGGPGDSP 


IGGPLDCS 
IGGPLSP 


IGGPDELS 
IGGPDLET 
IGGPDLVM 
IGGPDUCB 


IGGPCKAU 


IGGPALMD 
IGGPALSV 
IGGPALVR 
IGGPVRD 


IGGPRAEA 
IGGPRAG 
IGGPRAOR 
IGGPRAPA 
IGGPRAPC 
IGGPRAPD 
IGGPRAPU 
IGGPRARC 
IGGPRASC 
IGGPRAUR 
IGGPRAX 
IGGPXRIO 


Method of 
Operation 
Diagrams 


DL1, DL2 
DE2, DL1 
DL2, DM2 
DE1, DH1 


DH1, DI1 


DI1 
DI1 


EB1, EH1, EH2, 
EH3 


EH3 


DIS, EJ2 
EB1, EJ1, EJ4 


EJ1 
EF1 
EB1, EFI 


DI4, DI6 


DI5 


DB1, DF1 


DK1 
DB1, DK1, EG2 


EB1, EK1 


EK1 


DB1, DD1 


9, 10, 13 

9, 10, 14 

9, 10 

10, 11, 16 


11, 16 
11 


18, 38.2 
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Module Directory (continued) 
External Method of Program 
Module Descriptive Procedure Operation Organization 
Name Name Names Diagrams Figures 
IGGOCLBP UPDATE-Extend interface to DADSM IGGPRETI1 — — 
IGGPSPAC — 11, 16 
IGGOCLBQ LISTCAT Processing IGGPLSTC EB1, Ell 18 
IGGOCLBR Bit manipulation routine IGGPBMR DJ2 10, 17, 18 
IGGOCLBS Retrieval of derived catalog record IGGPXEXT — 9 
information 
IGGPXVAL DLI — 
IGGOCLBT Modification of derived volume catalog IGGPXDGO DM1 10 
record information 
IGGPXEL2 DM3 10 
IGGPXLT2 DM2 10 
IGGPXMOD DM1 = 
IGGOCLBU Catalog read/write format-4 DSCB IGGPF4DQ — 11, 16, 18 
IGGPF4RD EO! 11, 16, 18 
IGGPF4WR EO1 11, 16, 18 
IGGOCLBV Catalog SMF record build IGGPSMFA ED?2, ED4, ED5, 11, 16, 18, 
EE2 19 
IGGPSMFF eos —_ 
IGGPSMFL DK1 8, 16, 18 
IGGPSMFR =— — 
IGGPSMFS — 18 
IGGPSMFZ — — 
IGGOCLBW Modify: Delete/Insert Processing IGGPDEIN — 14 
IGGOCLBX DEFINE: 4th module IGGPDCIM — — 
IGGPDSPC ED1, ED3 19 
IGGOCLBY DEFINE: 5th module IGGPDRSP ED1, ED3 19 
IGGOCLBZ CONVERTYV processing IGGPCONV EO! 18 
IGGPGALO EO! 18, 38.5 
IGGPVALI EO! 18 
IGGOCLBO Define data and index characteristics IGGPCMKY — a 
IGGPDCCO — 19 
IGGPDCNV = — 
IGGPDPBI — — 
IGGPFPDA = —_ 
IGGPITER — — 
IGGOCLB1 Upgrade management IGGPUADD — 18 
IGGPUDEL EJ3 18 
IGGOCLB2 ALTER: Upgrade/Update IGGPALPG — — 
IGGPAUPG — 18 
IGGOCLB3 SMF GET/PUT for alter IGGPSMF — 10, 15 
IGGPSMFG — 9, 10, 13 
IGGOCLB4 DEFINE CRA IGGPDCRA EE3, EG2 18,19 
IGGPDCLS EJ3,EJ4 18 
IGGOCLB5 DELETE AIX/path IGGPDEAX EJ3 18 
IGGPDEPT EJ1, EJ3 18 
IGGPDIAX EJ4 18 
IGGPDIPT EJ3, EJ4 18 
IGGPDUPG EJ3, EJ4 18 
IGGOCLB6 ‘TSO interface for security IGGPCKCC — — 
IGGPINMD DD2 — 
IGGPSPSC DD!1 — 
IGGPWTSO — 8,18 
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Module Directory (continued) 


Module Descriptive 
Name Name 


IGGOCLB7 __ Reset reusable data set 


IGGOCLB8 DEFINE: Space recovery 


IGGOCLBI9 VSAM CMS DEFINE 


IGGOCLCA CVOL Processor 
IGGOCLC9 Catalog request initialization 
IGGOCLDA CRA services 


IGGOCKDC RACF Authorization Check 


IGGOCLDD RACF Definition Handling 


IGG026DU Catalog Dummy Module 


232 OS/VS2 Catalog Management Logic 


External 
Procedure 
Names 


IGGPRUS 


IGGPCNBO 
IGGPDFBO 
IGGPDUND 


IGGPPAIX 
IGGPPATH 


IGGOCLCA 
IGGOCLC9 


IGGPMODI 
IGGPRAPV 
IGGPWCAT 
IGGPWCRA 


IGGPRACG 
IGGPRACK 
IGGPRACS 

IGGPRACT 
IGGPRACV 


IGGPALRI 

IGGPALRN 
IGGPRDEF 
IGGPRDEL 
IGGPRDLC 
IGGPRFDC 
IGGPROBD 
IGGPRPTH 


IGG026DU 


Method of 
Operation 
Diagrams 


DE1, DI3, DI4, 
DI5, DI6 


ED3, EDS 


a 


Module Packaging 
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OS/VS2 Catalog Management modules reside in the pageable link pack area 
and in the job pack area. 


The following table lists the OS/VS2 Catalog Management load modules that 
are resident in the LPALIB library; they are loaded into the pageable 
link-pack area by nucleus initialization (NIP) at initial program load (IPL). 


Name Description OS/VS2 Catalog Management Modules 
IGGOCLA1 Catalog management IGGOCLAA, IGGOCLAB, IGGOCLAC, 
routines IGGOCLAD, IGGOCLAE, IGGOCLAF, 


IGGOCLAG, IGGOCLAH, IGGOCLAI, 
IGGOCLAJ, IGGOCLAK, IGGOCLAL, 
IGGOCLAM, IGGOCLAN, 
IGGOCLAO, IGGOCLAP, IGGOCLAQ, 
IGGOCLAR, IGGOCLAS, IGGOCLAT, 
IGGOCLAU, IGGOCLAV, 
IGGOCLAW, IGGOCLAX, 
IGGOCLAY, IGGOCLAZ, IGGOCLAI1, 
IGGOCLA2, IGGOCLA3, IGGOCLA4, 
IGGOCLAS, IGGOCLA6, IGGOCLA7, 
IGGOCLA8, IGGOCLA9, IGGOCLBA, 
IGGOCLBB, IGGOCLBC, IGGOCLBD, 
IGGOCLBE, IGGOCLBF, IGGOCLBG, 
IGGOCLBH, IGGOCLBI, IGGOCLBIJ, 
IGGOCLBK, IGGOCLBL, IGGOCLBM, 
IGGOCLBN, IGGOCLBO, IGGOCLBP, 
IGGOCLBQ, IGGOCLBR, IGGOCLBS, 
IGGOCLBT, IGGOCLBU, IGGOCLBV, 
IGGOCLBW, IGGOCLBX, IGGOCLBY, 
IGGOCLBZ, IGGOCLBO, IGGOCLB1, 
IGGOCLB2, IGGOCLB3, IGGOCLB4, 
IGGOCLBS, IGGOCLB6, IGGOCLB7, 
IGGOCLB8, IGGOCLB9, IGGOCLC9, 
IGGOCLDA, IGGOCLDC, IGGOCLDD 


IFGO191XK  OS/VS2 Catalog Open ACB IFGO191X 
Processor, Load 1 
IFGO191Y §OS/VS2 Catalog Open ACB IFG0191Y 


Processor, Load 2 


IFGO200N OS/VS2 Catalog Close/End of IFG0200N 
Volume ACB Processor : 


The following module is brought from the LINKLIB into the user’s job pack 
area whenever it is linked to or from the user’s program. 


Name Description OS/VS2 Catalog Management Module 
IGGOCLAO = Show catalog processor IGGOCLAO 


Directory 233 


Page of SY26-3826-3 
Revised July 28, 1978 
By TNL SN26-0912 


External Procedure Name Directory 


The external procedure directory is organized alphabetically by symbolic 
procedure name (external entry point name). It lists the module that contains 
the procedure, the descriptive name, and the method of operation diagrams 
and program organization figures in which that procedure is referenced. 


Procedure 
Name 


IDACAT11 
IDACAT 12 
IDACAT13 
IFGO191X 
IFGO191Y 
IFG0200N 
IFGOS550Y 
IGC0002F 
IGGPACDV 


IGGPADGO 
IGGPALEC 


IGGPALMD 
IGGPALPG 
IGGPALRI 
IGGPALRN 
IGGPALSV 
IGGPALT 


e 


IGGPALT2 
IGGPALVL 
IGGPALVR 
IGGPANVV 
IGGPAOCI 


IGGPARFS 
IGGPAUPG 
IGGPAXCI 


IGGPBJFB 
IGGPBMR 
IGGPCBPT 
IGGPCCBC 
IGGPCCCR 
IGGPCDVR 


IGGPCKAU 


Module 
Name 


IDACAT11 
IDACAT12 
IDACAT13 
IFG0191X 
IFG0191Y 
IFG0200N 
IFG0200N 
IGC0002F 
IGGOCLAB 


IGGOCLAW 
IGGOCLBE 


IGGOCLBN 
IGGOCLB2 

IGGOCLDD 
IGGOCLDD 
IGGOCLBN 
IGGOCLBD 


IGGOCLAX 
IGGOCLBE 
IGGOCLBN 
IGGOCLBE 
IGGOCLAG 


IGGOCLAT 
IGGOCLB2 
IGGOCLAG 


IGGOCLA6 
IGGOCLBR 
IGGOCLA6 
IGGOCLA9 
IGGOCLAG 
IGGOCLAT 


IGGOCLBM 


Descriptive 
Name 


Private (User's) Catalog Open 

Private (User’s) Catalog Close 

Private Catalog Task Termination 
Catalog Open ACB Processor, Load 1 
Catalog Open ACB Processor, Load 2 
Catalog Close ACB Processor 
Catalog EOV ACB Processor 

OS/VS Catalog Management 


Catalog Management Driver 


Add Group Occurrence (Set of Fields) 


Check for Index or Data and Sequence 
Set with Data 


Update Security Information 
Verify No Open Pagespace 
Alter RACF Indicator 
Rename RACF Profile 

Sort Volume Serial List 
ALTER Processing 


Alter Catalog Record’s Field Value 
ALTER: Volume Processing 
ALTER: Volume Processing 
ALTER: Volume processing 


Assign Contiguous Control Intervals 


Tracking Table Spill Routine 
ALTER Upgrade/Update 
Assign One Control Interval 


Build JFCB 

Bit-Map Manipulation Routine 
Compute Blocks of Track Value 
Catalog Control Block Cleanup 
Checkpoint the Catalog Control Record 


Catalog Management Services: Initial 
Processing 


Check the Caller’s Authorization To 
Access the Catalog Record 
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DB1, DD1, EB1 


DB1, DD1 


10, 18, 19, 
24 


18 


13, 16, 18, 
25 


10, 17, 18 


‘S 


External Procedure Name Directory (continued) 


Procedure 
Name 


| IGGPCKCC 


> 


IGGPCMKY 
IGGPCMRR 
IGGPCNBO 
1GG026DU 
IGGPCONV 
IGGPCPLR 
IGGPCRTC 
IGGPCSDO 
IGGPCSCP 
IGGPCVX 
IGGPDALL 
IGGPDAVO 


IGGPDBDI 


IGGPDBVC 
IGGPDCCE 


IGGPDCCO 
IGGPDCDA 
IGGPDCIM 
IGGPDCLS 
IGGPDCMB 


IGGPDCME 


IGGPDCNV 
IGGPDCRA 
IGGPDCRC 
IGGPDEAX 
IGGPDEF 
IGGPDEFA 
IGGPDEFB 
IGGPDEFC 
IGGPDEFS 


IGGPDEFX 
IGGPDEIN 
IGGPDEL 


IGGPDELB 


Module 
Name 


IGGOCLB6 


IGGOCLBO 
IGGOCLA9 
IGGOCLB8 


IGGOCLBZ 
IGGOCLAG 
IGGOCLA6 
IGGOCLAH 
IGGOCLA3 
IGGOCLA3 
IGGOCLAS 
IGGOCLBH 


IGGOCLAJ 


IGGOCLAM 
IGGOCLAN 


IGGOCLBO 
IGGOCLAP 
IGGOCLBX 
IGGOCLB5 
IGGOCLAK 


IGGOCLAE 


IGGOCLBO 
IGGOCLB4 
IGGOCLAS 
IGGOCLB5 
IGGOCLAL 
IGGOCLBH 
IGGOCLA4 
IGGOCLAS 
IGGOCLAQ 


IGGOCLAO 
IGGOCLBW 
IGGOCLBG 


IGGOCLAS5 


Descriptive 
Name 


Check for RACF-Defined 
Catalog 


Check Key-Range Overlap 

Catalog Management Recovery Routine 
Remove Candidate Volume Occurrences 
Catalog Dummy Module 

CONVERTYV Processing 

Check Preformat of Low-Key Range 
Convert Records to Tracks 

Dynamic Catalog Open Driver 

Search Catalog 

CVOL Set-Up Subfunction 

Delete Alias Chain 


DEFINE NONVSAM: Build the Volume Information 
Set of Fields 


DEFINE: Build the Data Set and Index 
Catalog Records of a Cluster 
DEFINE: Validity-check control blocks 


DEFINE: Build the Cluster’s Catalog 
Record 


DEFINE Data and Index Characteristics 
DEFINE CATALOG Processing (2nd of 2) 
Integer Conversion Routine 

DELETE Cluster/AIX Records 


DEFINE: Completion (Build the Volume 
Information Sets of Fields) 


DEFINE CATALOG: Catalog Open, Build, 
and Close 


Candidate Volume Determination Routine 
DEFINE CRA 

RBA Computing Routine 

Explicit DELETE AIX 

DEFINE: Initial Processing 

DEFINE NONVSAM Processing 
DEFINE GDGBASE Processing 

DEFINE CATALOG Processing (Ist of 2) 
DEFINE SPACE Processing 


DEFINE ALIAS Processing 
Modify: Delete/Insert Processing 


DELETE CLUSTER/AIX/PATH/PAGESPACE/ 
NONVSAM Processing 


DELETE GDG BASE processing 
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External Procedure Name Directory (continued) 


Procedure 
Name 


IGGPDELC 
IGGPDELS 
IGGPDELX 
IGGPDEL2 
IGGPDEMV 


IGGPDEPT 
IGGPDEXA 
IGGPDFBO 
IGGPDFM1 


IGGPDFRS 


IGGPDFS2 


IGGPDF4T 
IGGPDGDS 
IGGPDGO 


IGGPDGOP 


IGGPDIAX 
IGGPDIPT 
IGGPDLET 
IGGPDLVM 
IGGPDLXT 
IGGPDOG 
IGGPDOPN 
IGGPDPBI 
IGGPDRDA 
IGGPDRSP 
IGGPDSCB 


IGGPDSPC 
IGGPDTIM 
IGGPDUCB 
IGGPDUND 
IGGPDUPG 
IGGPDUSC 


IGGPDVMV 
IGGPEMIO 


Module 
Name 


IGGOCLAF 
IGGOCLBL 
IGGOCLAS 
IGGOCLAV 
IGGOCLA7T 


IGGOCLB5 
IGGOCLBG 
IGGOCLB8 
IGGOCLAI 


IGGOCLA8 


IGGOCLA6 


IGGOCLA7 
IGGOCLA4 
IGGOCLAX 


IGGOCLAX 


IGGOCLBS5 
IGGOCLB5 
IGGOCLBL 
IGGOCLBL 
IGGOCLBG 
IGGOCLA3 
IGGOCLBG 
IGGOCLBO 
IGGOCLAN 
IGGOCLBY 
IGGOCLAN 


IGGOCLBX 
IGGOCLAL 
IGGOCLBL 
IGGOCLB8 
IGGOCLBS5 
IGGOCLA7 


IGGOCLA7 
IGGOCLAF 


Descriptive 
Name 


DELETE CATALOG Processing 
DELETE SPACE Processing 
DELETE ALIAS NAME processing 
Delete a Set of Fields 


DELETE: Extract the volume information 
set of fields 


Explicit DELETE PATH 

Extract Associations 

DEFINE: Space Recovery 

Scratch Format-1 DSCB 

Free Unused and Unneeded Storage 
Resources 


DEFINE SPACE: Build the data space group 
and data set directory entry sets of fields 


Format-4 Volume Record Timestamp 
Generation Data Set Determination 


Modify: Delete Group Occurrence (Set of 
Fields) Processing 


Modify: Delete Group Occurrence Pointer 
(Set of Fields Pointer) Processing 


Implicit DELETE AIX 

Implicit DELETE PATH 

Delete Volume Entry Records 

Build Volume Mount Interface 

DELETE Exit Routine 

Search Catalog —New Orientation 

OPEN Determination 

Determine Physical Block Size Index Value 
DEFINE AMDSB Processing 

DEFINE CLUSTER Processing (Sth Module) 


DEFINE: Initial Processing (Space 
Calculations and Build the Cluster 
Catalog Record) 


DEFINE CLUSTER Processing (4th Module) 
DEFINE: Call the system timer 


DEFINE: Undo the Previous Processing 
Upgrade Processing 


DELETE: Scratch the data space (format 
1—identifier—DSCB) from the volume’s 
VTOC 


DELETE: Mount and verify volumes 
[/O Error Message Writer 
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EB1, EK1 
EB1, EM! 
DM3 


EC1, ED1, ED3 


ED1, ED3 
EC 


ED1, ED3 


EJ3, EJ4 


External Procedure Name Directory (continued) 


Procedure 
Name 


IGGPEMSG 
IGGPERUG 


IGGPEXPD 


IGGPEXT 


IGGPFDSP 
IGGPFPDA 
IGGPF4DQ 
IGGPF4RD 


IGGPF4WR 
IGGPGALO 
IGGPGDGL 
IGGPGDSP 
IGGPGET 


IGGPGETC 


IGGPGLOC 
IGGPGNEX 
IGGPGPCC 
IGGPGRE 

IGGPGREC 
IGGPGREL 
IGGPGVAL 


IGGPIGOP 


IGGPINIT 
IGGPINMD 
IGGPIORA 


IGGPISCI 


IGGPITER 


IGGPLDCS 
IGGPLOC 
IGGPLSP 
IGGPLSTC 


Module 
Name 


IGGOCLAF 
IGGOCLA4 


IGGOCLAX 


IGGOCLAZ 


IGGOCLAI 
IGGOCLBO 
IGGOCLBU 
IGGOCLBU 


IGGOCLBU 
IGGOCLBZ 
IGGOCLA2 
IGGOCLBJ 
IGGOCLBI 


IGGOCLBI 


IGGOCLA2 
IGGOCLAW 
IGGOCLA3 
IGGOCLA3 
IGGOCLBA 
IGGOCLAW 
IGGOCLBA 


IGGOCLAW 


IGGOCLBC 
IGGOCLB6 
IGGOCLAG 


IGGOCLAG 


IGGOCLBO 


IGGOCLBK 
IGGOCLAZ 
IGGOCLBK 
IGGOCLBQ 


Descriptive 


Name 


Error Message Writer 


Delete Reference to Generation Data Set in 
GDG Base Catalog Record 


Expand a Catalog Record’s Variable- 
length Field 


Extract catalog record field 


Force Delete Space 

Dynamic Allocation Processing 
Dequeue the Format 4 DSCB 
Read the Format 4 DSCB 


Write the Format 4 DSCB 

CONVERTV: Get all Low-Range Records 
Locate GDG Base catalog record 
LOCATE: GENDSP Processing 


GET: Call VSAM Record Management 
to Retrieve A Catalog Record 


GET: Call VSAM Record Management to 
Retrieve a Catalog Record 


Generic LOCATE 

Format a New Catalog Extension Record 
Obtain PCCB Subfunction 

Get real catalog record 

Retrieve a Catalog Record 

Get Relative Repetition Number for Add 
Get A Catalog Record Field 


Insert A Group Occurrence Pointer 
(Set-of-Fields Pointer) 
UPDATE-Extend: Initialization 
Build User Authorization Interface 


Decode VSAM Record Management I/O 
Error Codes 


Ensure Catalog Control Interval 
Availability 


Adjust Data Control Interval Number 
Downward 


LSPACE: Gather the Available-Space Data 
Locate catalog data fields 

LSPACE Processing 

LISTCAT Processing 
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External Procedure Name Directory (continued) 


Procedure 
Name 


IGGPMCO 


IGGPMCO2 


IGGPMCRA 
IGGPMEBM 


IGGPMGO 


IGGPMOD 


IGGPMODI 
IGGPPAD 


IGGPPADC 


IGGPPAIX 
IGGPPATH 
IGGPPDE 


IGGPPDEC 


IGGPPREC 


IGGPPSEM 
IGGPPUPC 


IGGPQNQC 
IGGPRACC 
IGGPRACG 
IGGPRACK 
IGGPRACS 


IGGPRACT 
IGGPRACV 
IGGPRAEA 
IGGPRAG 

IGGPRAOP 
IGGPRAOR 
IGGPRAPA 
IGGPRAPC 
IGGPRAPD 
IGGPRAPU 
IGGPRAPV 


Module 
Name 


IGGOCLAC 


IGGOCLAD 


IGGOCLA7 
IGGOCLAE 


IGGOCLAX 


IGGOCLAV 


IGGOCLDA 
IGGOCLAG 


IGGOCLAG 


IGGOCLB9 
IGGOCLB9 
IGGOCLAG 


IGGOCLAG 


IGGOCLAW 


IGGOCLAN 
IGGOCLAG 


IGGPCLAH 
IGGOCLBO 
IGGOCLDC 
IGGOCLDC 
IGGOCLDC 


IGGOCLDC 
IGGOCLDC 
IGGOCLBO 
IGGOCLBO 
IGGOCLAD 
IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLDA 


Descriptive 
Name 


DEFINE CATALOG: Master Catalog Build and 
Open (1st of 2) 


DEFINE CATALOG: Master Catalog Build and 
Open (2nd of 2) 


DELETE: Verify CRA Volume Mount 


Handle multiple extents for catalog open 
and build 


Move Group Occurrences (Sets-of-Fields) 
From One Extension Record Into Another 


Modify: Initial Processing 


Build Interface to MODIFY Function 


PUT Add: Call VSAM Record Management To 
Write A New Catalog Record 


DEFINE AIX 
DEFINE PATH 


ERASE: Call VSAM Record Management to 
Erase A Catalog Record 


ERASE: Call VSAM Record Management to 
Erase a Catalog Control Interval 


Call PUT-Add or PUT-Update to Write a 
Catalog Record, Then Call SMF 


DEFINE: Validity-check Input Parameters 


PUT-Update: Call VSAM Record Management to 


Rewrite A Catalog Record 

Check for entryname conflicts 
Checkpoint CRA CCR 

RACHECK for Implicit Alter Delete 
RACHECK Routine 


Perform Set-Up for 
Extract 


RACF Catalog Verification 
RACF Verification Routine 
CRA I/O Error Analysis 
CRA GET 

Open CRA 

Orient to CRA 

CRA Put Add 

CRA Record Chain 

CRA Put Delete 

CRA Put Update 

Format-4 DSCB Timestamp Processing 
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DM1, DM3, EH3 


EE3 


18 


13, 14, 16 


10, 11, 12, 
16, 18, 19 


10, 18, 22 


19 
19 
15, 18, 23 


18 


10, 13, 15 


11, 16, 18, 
21 


External Procedure Name Directory (continued) 


Procedure 
Name 


IGGPRARA 
IGGPRASC 
IGGPRAX 

IGGPRCCR 
IGGPRDEF 
IGGPRDEL 
IGGPRDLC 


IGGPRET1 
IGGPRFDC 
IGGPROBD 
IGGPRPLF 
IGGPRPLM 
IGGPRPTH 
IGGPRUS 


IGGPSALL 


IGGPSALS 
IGGPSCAT 
IGGPSCNC 
IGGPSC2 


IGGPSGOP 


IGGPSHNK 


IGGPSLEI 
IGGPSLEL 
IGGPSLEN 
IGGPSLOC 
IGGPSMF 
IGGPSMFA 


IGGPSMFF 
IGGPSMFG 
IGGPSMFL 
IGGPSMFR 
IGGPSMFS 
IGGPSMFZ 
IGGPSPAC 
IGGPSPSC 


Module 
Name 


IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGPCLAG 
IGGOCLDD 
IGGOCLDD 
IGGOCLDD 


IGGOCLBP 
IGGOCLDD 
IGGOCLDD 
IGGOCLA3 
IGGOCLA3 
IGGOCLDD 
IGGOCLB7 


IGGOCLAR 


IGGOCLAU 
IGGOCLAH 
IGGOCLAY 
IGGOCLAH 


IGGOCLAV 


IGGOCLAX 


IGGOCLAM 
IGGOCLAM 
IGGOCLAA 
IGGOCLAM 
IGGOCLB3 
IGGOCLBV 


IGGOCLBV 
IGGOCLB3 

IGGOCLBV 
IGGOCLBV 
IGGOCLBV 
IGGOCLBV 
IGGOCLBP 
IGGOCLB6 


Descriptive 
Name 


Read CRA CCR 

Ensure Sufficient CRA Control Intervals 
CRA Exit Routine 

Read the catalog control record (CCR) 
Define a RACF Profile 

Delete a RACF Profile 


Delete RACF Profiles for 
Partially-Defined Cluster 


Return point from DADSM EXTEND 
RACF Force Delete Catalog 

RACF Delete Array of Profiles 

Drop catalog orientation for this request 
RPL Manager 

RACF Delete Profile for Path 

Reset Reusable Data Set 


Suballocate: Candidate Volume Assignment 


Suballocate: Space Assignment 
Search Catalog Processing 
Initial CTGPL Processing 
Search the catalog (part 2) 


Search For a Group Occurrence Pointer 
(Set-of-Fields Pointer) 


Shrink A Catalog Record’s Variable-Length 
Field 


Extract Initialization: Build CTGPL, CTGFLs 
Process Elementary Entry 

Process Base Data Record 

LOCATE: Super-Locate Processing 
SMF-for-ALTER: Write Processing 

SMF: Build a Format-63 SMF Record 


SMF: Free the Virtual Storage Obtained 
SMF-for-ALTER: Read Processing 

SMF: Build a Format-69 SMF Record 

SMF: Build a Format-68 SMF Record 

SMF: Build a Format-67 SMF Record 

SMF: Set the Password Set of Fields to Zero 
UPDATE-Extend: Obtain More Space 
Check for Security By-Pass 
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External Procedure Name Directory (continued) 


Procedure 
Name 


IGGPSSCR 


IGGPSVOL 


IGGPTNXO 
IGGPTSTS 
IGGPTXO 
IGGPUADD 
IGGPUCRS 
IGGPUDEL 
IGGPUPD 
IGGPUPDE 
IGGPVALI 
IGGPVRD 
IGGPVMSC 


IGGPWCAT 
IGGPWCRA 


IGGPWFLR 
IGGPWTSO 
IGGPXDGO 
IGGPXEL2 
IGGPXEXT 
IGGPXIO 


IGGPXLT2 
IGGPXMOD 
IGGPXRIO 
IGGPXVAL 
IGGOCLAO 
IGGOCLAI 
IGGOCLCA 
IGGOCLC9 


Module 
Name 


IGGOCLBF 


IGGOCLBC 


IGGOCLBI 
IGGOCLBA 
IGGOCLBI 
IGGOCLB1 
IGGOCLBI 
IGGOCLB1 
IGGOCLAV 
IGGOCLBB 
IGGOCLBZ 
IGGOCLBN 
IGGOCLA7 


IGGOCLDA 
IGGOCLDA 


IGGOCLAG 
IGGOCLB6 
IGGOCLBT 
IGGOCLBT 
IGGOCLBS 
IGGOCLAG 


IGGOCLBT 
IGGOCLBT 
IGGOCLBO 
IGGOCLBS 
IGGOCLAO 
IGGOCLAI 
IGGOCLCA 
IGGOCLC9 


Descriptive 
Name 


Subscratch: Release A Cluster’s 
Space Within a VSAM Data Space 


Search For the Volume Information Set 
of Fields 


Calculate SUMTT Value 
CTGFL-for-Tests Processing 
Update SUMTT in Volume Record 
Add Upgrade Association 

GET a CRA Record by CI Number 
Delete Upgrade Association 
UPDATE: Initial Processing 
UPDATE-Extend Processing 
CONVERTV: Validity Checking 


ALTER: Remove VSAM Space from Volume 
DELETE: Delete all space information in the 


the volume catalog record 


Write Volume Records 


Write Self-Describing and Volume Records 


to CRA 
Write Free Record 


Write Messages To A TSO Terminal User 


Add Derived Group Occurrence 
Delete Derived Group Occurrence 
Extract Derived Group Occurrence 


Issue the GET, PUT, or ERASE Macro 


Instructions to VSAM Record Management 


Alter Derived Field Value 

Modify Derived Group Occurrence 
CRA GET/PUT Routine 

Get Derived Field Value 

Show Catalog Processing 

Catalog Management First Load 
CVOL Processor 


Catalog Management Initialization 


240 OS/VS2 Catalog Management Logic 


Method of 
Operation 


Diagrams 


DIi 


DI5 
DE1, DH1 


EJ3 

DB1, DH1,DI3 
DH1, DIi 

EOI 

EH3 

EJ2 


E]2 

AAI, CA1, DB1 
DB1 

DBI 


11 


11, 12, 16 
9,10 

11, 12, 16 
18 

18 

8, 10 

10, 11, 16 
18 

18 

18 


Procedure Calls Directory 


This table contains each Catalog Management module and external and 
internal procedures within each module. The internal and external calls of 
each procedure are listed. 


Calling 
Module and its 
procedures 


IGGOCLAA 
External 


IGGPSLEN 


Internal 
IGGPSLCG 
IGGPSLIV 
IGGPSLR 


IGGPSLY 


IGGOCLAB 
External 


IGGPACDV 


IGGOCLAC 
External 
IGGPMCO 

IGGOCLAD 
External 
IGGPMCO2 
IGGPRAOP 

IGGOCLAE 
External 
IGGPDCME 
IGGPMEBM 
Internal 
IGGPDCBO 


IGGPDCCB 
IGGPDCOC 


IGGPDCPR 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPSLEL (AM) 


IGGPEXT (AZ), IGGPGET (BI) 


IGGPEXT (AZ), IGGPGET (BI), 
IGGPSLEL (AM) 


IGGPEXT (AZ), IGGPGET (BD), 
IGGPSLEL (AM) 


IGGPCDVR (AT), IGGPCKAU (BM), 


IGGPGDSP (BJ), IGGPLOC (AZ), 
IGGPLSP (BK), IGGPMCO (AC), 
IGGPSCAT (AH), IGGPSCNC (AY), 
IGGPSLOC (AM), IGGPUPD (AV) 


IGGPMCO2 (AD) 


IGGPDCRC (AS), IGGPMOD (AV) 
IGGPBMR (BR) 


IGGPDUND (B8), IGGPF4RD (BU), 
IGGPF4WR (BU) 


IGGPARFS (AT), IGGPMCO2 (AD), 
IGGPSMFA (BV) 


IGGPXIO (AG) 


Internal procedures called 
(Procedures within the module) 


IGGPSLCG, IGGPSLIV, 
IGGPSLR, IGGPSLY 


IGGPSLY 


IGGPSLY 


IGGPDCOC 


— 


IGGPDCBO, IGGPDCCB, 


IGGPDCPR 


Directory 241 


Procedure Calls Directory (continued) 


Calling 
Module and its 


Procedures 


IGGOCLAF 


External 
IGGPDELC 


IGGPEMIO 
IGGPEMSG 
Internal 

IGGPDCDS 


IGGPDLER 
IGGPNFND 
IGGPSDSP 


IGGOCLAG 
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External 
IGGPANCI 


IGGPAOCI 


IGGPAXCI 


IGGPCCCR 
IGGPIORA 
IGGPISCI 


IGGPPAD 
IGGPPADC 
IGGPPDE 


IGGPPDEC 
IGGPPUPC 
IGGPRCCR 
IGGPXIO 
Internal 
IGGPCHAC 
IGGPCPLR 
IGGPRBAP 
IGGPTRPL 
IGGPWFLR 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPCCCR (AG), IGGPDALL (AS), 
IGGPDBVC (AM), IGGPEXT (AZ), 
IGGPFDSP (AI), IGGPF4RD (BU), 
IGGPF4WR (BU), IGGPGET (BI), 
IGGPPDE (AG), IGGPRPLF (A3), 
IGGPSCAT (AH), IGGPXIO (AG) 


IGGPARFS (AT), IGGPDOPN (BG), 
IGGPEXT (AZ) 


IGGPDF4T (A7) 


IGGPEMIO (AF), IGGPEMSG (AF) 
IGGPGET (BI), IGGPRASC (BO) 


IGGPRAPA (BO), IGGPRAPU (BO) 


IGGPRAPD (BO) 


IGGPRAPU (BO) 


Internal procedures called 
(Procedures within the module) 


IGGPDLER, IGGPSDSP 


IGGPNFND 


IGGPCHAC, IGGPIORA, 
IGGPWELR, IGGPXIO 


IGGPANCI, IGGPCCCR, 
IGGPRCCR, IGGPXIO 


IGGPANCI, IGGPCCCR, 
IGGPRCCR, IGGPXIO 


IGGPRBAP, IGGPXIO 


IGGPANCI, IGGPCCCR, 
IGGPRCCR, IGGPXIO 


IGGPRCCR, IGGPXIO 


IGGPRCCR, IGGPTRPL, 
IGGPXIO 


IGGPTRPL, IGGPXIO 
IGGPRBAP, IGGPXIO 
IGGPIORA 


IGGPWFLR 


IGGPXIO 
IGGPIORA, IGGPXIO 
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By TNL SN26-0912 
Procedure Calls Directory (continued) 
External procedures called 
Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
IGGOCLAH 
External 
IGGPCSDO  IGGPCVX (A3), IGGPDOG (A3) IGGPACI 
IGGPQNQC  IGGPGET (BI) — 
IGGPSCAT IGGPUCRS (BI) IGGPIOSI, IGGPQNQC, 
IGGPSCA, IGGPSC2 
IGGPSC2 IGGPSCCP (A3), IGGPDOG (A3) IGGPPCCP 
Internal 
IGGPACI IGGPGPCC (A3), IGGPRPLF (A3) — 
IGGPIOSI — — 
IGGPPCCP IGGPDOG (A3), IGGPGPCC (A3) IGGPCSDO 
IGGPSCA — _ 
IGGOCLAI 
External 
IGGPDFM1 IGGPF4DQ (BU), IGGPF4RD (BU) — 
IGGPFDSP IGGPARFS (AT), IGGPDLET (BL), IGGPFDEX, IGGPFDXT 
IGGPDLVM (BL), IGGPDOPN (BG), 
IGGPDUCB (BL), IGGPEXT (AZ), 
IGGPGET (BI), IGGPMOD (AV), 
IGGPPUPC (AG) 
Internal 
IGGPFDEX — — 
IGGPFDXT — = 
IGGOCLAJ 
External 
IGGPDBDI IGGPDCMB (AK), IGGPDFBO (B8), IGGPDCNV, IGGPDRCS, 
IGGPDFRS (A8), IGGPDTIM (AL), IGGPDSPO 
IGGPGET (BI), IGGPSMFA (BV), 
IGGPUADD (B1) 
Internal 
IGGPDCNV IGGPARFS (AT), IGGPSALL (AR) — 
IGGPDCNV (BO) 
IGGPDEXD IGGPARFS (AT) — 
IGGPDRCS — —_ 
IGGPDSEX  IGGPARFS (AT) IGGPDEXD 
IGGPDSPO IGGPCNBO (B8), IGGPDEFS (AQ), IGGPDSEX 
IGGPGET (BI), IGGPSALL (AR), 
IGGPTNXO (BI), IGGPTXO (BI) 
IGGOCLAK 
External 
IGGPDCMB — IGGPDBVO, IGGPDMOP, 


IGGPDOMF 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


Internal 
IGGPDBCV 
IGGPDBVO 


IGGPDEXD 
IGGPDMOP 
IGGPDOMF 
IGGPDRCA 
IGGPDRNG 
IGGPDSSP 


IGGOCLAL 


External 
IGGPDEF 
IGGPDTIM 
Internal 
IGGPDBVC 
IGGPDCAV 


IGGPDCDE 
IGGPDCSF 
IGGPDCWC 
IGGPDDEP 


IGGPDDNP 
IGGPDEDE 


IGGPDFSC 
IGGPDRPG 
IGGPDSTY 
IGGPDWAI 


IGGOCLAM 
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External 
IGGPDBVC 
IGGPSLEL 
IGGPSLOC 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPARFS (AT) 
IGGPARFS (AT) 


IGGPARFS (AT) 
IGGPARFS (AT), IGGPMOD (AV) 
IGGPSMFA (BV) 


IGGPDSCB (AN) 


IGGPFPDA (BO) 


IGGPGET (BI), IGGPQNQC (AH), 
IGGPRDEF (DD) ; 


IGGPCMKY (BO) 


—— 


IGGPEXT (AZ) 


IGGPGDGL (A2), IGGPGLOC (A2), 


IGGPSLEN (AA) 


Internal procedures called 
(Procedures within the module) 


IGGPDEXD 


IGGPDBCV, IGGPDEXD, 
IGGPDRCA, IGGPDRNG, 
IGGPDSSP 


IGGPDEXD 


IGGPDCAV, IGGPDDEP 


IGGPDBVC, IGGPDCSF, 
IGGPDCWC, IGGPDDNP, 
IGGPDFSC, IGGPDRPG 


IGGPDBVC 
IGGPDBVC 


IGGPDCDE, IGGPDEDE, 
IGGPDSTY, IGGPDWAI 


IGGPDTIM 


IGGPDBVC 


IGGPDBVC 


IGGPSLIN 


Procedure Calls Directory (continued) 


Calling 
Module and its 


Procedures 


Internal 
IGGPSLEI 
IGGPSLER 
IGGPSLEX 
IGGPSLE2 
IGGPSLIN 


IGGOCLAN 


External 
IGGPDCCE 
IGGPDRDA 
IGGPDSCB 


IGGPPSEM 
Internal 
IGGPDALR 
IGGPDBSF 
IGGPDSPF 
IGGPDUND 
IGGPXDCI 


IGGOCLAO 


External 


IGGPDEFX 


Internal 
IGGPBCFI 
IGGPMCFI 


IGGOCLAP 


External 
IGGPDCDA 
Internal 
IGGPDCON 
IGGPDCPC 


IGGPDCSP 
IGGPDCVS 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPEXT (AZ), IGGPGET (BI) 
IGGPEXT (AZ) 


IGGPAOCI (AG), IGGPPAD (AG) 
IGGPDRSP (BY), IGGPDSPC (BX) 


IGGPDBDI (AJ), IGGPDCDA (AP), 
IGGPDEFC (AS) 


IGGPAXCI (AG), IGGPEXT (AZ), 
IGGPGET (BI), IGGPMOD (AV), 
IGGPPDE (AG), IGGPSMFA (BV) 


IGGPMOD (AV) 


IGGPAXCI (AG), IGGPDCCE (AN), 


IGGPPAD (AG) 


— 


Page of SY26-3826-3 
Revised July 28, 1978 
By TNL SN26-0912 


Internal procedures called 
(Procedures within the module) 


IGGPSLEX 


IGGPDBVC, IGGPSLEL, 
IGGPSLE2 


IGGPDCCE 


IGGPDALR, IGGPDBSF, 
IGGPDRDA, IGGPDSPF, 
IGGPDUND 


IGGPXDCI 


IGGPBCFI, IGGPMCFI 


IGGPDCVS 


IGGPDCON, IGGPDCPC 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


IGGOCLAQ 


External 


IGGPDEFS 


Internal 
IGGPCOBT 
IGGPDSXT 
IGGPFIBO 
IGGPF4PR 


IGGPIVER 
IGGPVMTV 


IGGOCLAR 


External 


IGGPSALL 


IGGOCLAS 
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External 
IGGPDCRC 
IGGPDEFC 


Internal 
IGGPDCBE 
IGGPDCEB 
IGGPDCFL 
IGGPDCHD 
IGGPDCIX 
IGGPDCLD 
IGGPDCME 
IGGPDCPB 
IGGPDCSP 


IGGPDCVO 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPARFS (AT), IGGPAXCI (AG), 
IGGPBJFB (A6), IGGPCBPT (A6), 
IGGPCKAU (BM), IGGPCRTC (A6), 
IGGPDCRA (B4), IGGPDFS2 (A6), 
IGGPDTIM (AL), IGGPGET (BD, 
IGGPISCI (AG), IGGPLSP (BK), 
IGGPPAD (AG), IGGPSCAT (AH) 


IGGPARFS (AT) 


IGGPF4DQ (BU), IGGPF4RD (BU), 
IGGPF4WR (BU) 


IGGPEXT (AZ), IGGPGET (BI), 
IGGPISCI (AG), IGGPMOD (AV), 
IGGPSALS (AU) 


IGGPCCCR (AG), IGGPDCME (AE) 


IGGPARFS (AT), IGGPDCRA (B4), 
IGGPDEFS (AQ), IGGPMEBM (ABE), 
IGGPSALL (AR) 


Internal procedures called 
(Procedures within the module) 


IGGPCOBT, IGGPDSXT, 
IGGPF1BO, IGGPF4PR, 
IGGPIVER, IGGPVMTV 


— 


IGGPDCBE, IGGPDCSP, 


IGGPDCVO 


IGGPDCEB, IGGPDCPB 


IGGPDCME 
IGGPDCRC 
IGGPDCRC 
IGGPDCRC 


IGGPDCFL, IGGPDCHD, 
IGGPDCIX, IGGPDCLD 


Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


IGGOCLAT 
External 
IGGPARFS 
IGGPCDVR 


Internal 
IGGPCCLN 
IGGPDYNA 


IGGPDYNB 
IGGPDYNC 
IGGPDYND 


IGGOCLAU 
External 
IGGPSALS 
Internal 
IGGPEDS 

IGGOCLAV 
External 
IGGPDEL2 


IGGPMOD 
IGGPSGOP 
IGGPUPD 
Internal 


IGGPSFPL 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


— 


IGGPALRI (DD), IGGPALT (BD), 
IGGPCKAU (BM), IGGPCONV (BZ), 
IGGPDEF (AL), IGGPDEFA (BH), 
IGGPDEFB (A4), IGGPDEFS (AQ), 
IGGPDEFX (A4), IGGPDEL (BG), 
IGGPDELB (A5), IGGPDELC (AF), 
IGGPDELS (BL), IGGPDELX (A5), 
IGGPGET (BI), IGGPLSTC (BQ), 
IGGPRDEF (DD), IGGPRDEL (DD), 
IGGPRDLC (DD), IGGPRFDC (DD), 
IGGPSCAT (AH) 


IGGPRPLF (A3), IGGPRPLM (A3) 


— 


—_— 


IKJEFF18 (IKJEFF18) 


IGGPBMR (BR), IGGPEXT (AZ) 


IGGPBMR (BR) 


IGGPDGO (AX), IGGPDGOP (AX), 
IGGPGREC (BA), IGGPPDE (AG), 
IGGPPREC (AW), IGGPSMF (B3) 


IGGPSCNC (AY), IGGPXMOD (BT) 
IGGPGREC (BA) 
IGGPRUS (B7), IGGPUPDE (BB) 


IGGPGREC (BA), IGGPPREC (AW), 
IGGPSMFG (B3), IGGPTSTS (BA), 
IGGPXDGO (BT), IGGPXEL2 (BT), 
IGGPXLT2 (BT) 
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Internal procedures called 
(Procedures within the module) 


—— 


IGGPARFS, IGGPCCLN, 
IGGPDYNA, IGGPDYNB, 
IGGPDYNC, IGGPDYND 


IGGPARFS 


IGGPARFS, IGGPDYNB, 
IGGPDYND 


IGGPDYNC 


IGGPEDS 


IGGPSGOP 


IGGPSFPL 


—_ 


IGGPSFPL 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


IGGOCLAW 


External 


IGGPADGO 


IGGPGNEX 
IGGPGREL 
IGGPIGOP 
IGGPPREC 


Internal 
IGGPAGOP 


IGGPASPT 
IGGPMVGO 


IGGOCLAX 


External 
IGGPALT2 
IGGPDGO 
IGGPDGOP 
IGGPEXPD 
IGGPMGO 


IGGPSHNK 
Internal 
IGGPCGO 
IGGPMBGO 


IGGPMVAR 


IGGOCLAY 


External 
IGGPSCNC 
Internal 
IGGPSNVC 


IGGOCLAZ 
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External 
IGGPEXT 
IGGPLOC 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPAXCI (AG), IGGPGREC (BA) 


IGGPGREC (BA) 


IGGPPAD (AG), IGGPPUPC (AG), 
IGGPSMF (B3) 


IGGPAXCI (AG), IGGPGREC (BA), 
IGGPMGO (AX) 


IGGPAOCI (AG), IGGPGVAL (BA) 


IGGPIGOP (AW), IGGPSGOP (AV) 


IGGPAXCI (AG), IGGPGNEX (AW), 
IGGPGREC (BA) 


IGGPAXCI (AG), IGGPDEIN (BW), 
IGGPGNEX (AW), IGGPGREC (BA), 
IGGPGVAL (BA) 


IGGPSCNC (AY), IGGPXEXT (BS) 


Internal procedures called 
(Procedures within the module) 


IGGPAGOP, IGGPASPT, 
IGGPGNEX, IGGPGREL, 
IGGPIGOP, IGGPMVGO 


IGGPPREC 


IGGPASPT, IGGPGNEX, 
IGGPGREL, IGGPIGOP 


IGGPIGOP 


IGGPMVAR 


IGGPCGO, IGGPDGO, 
IGGPDGOP 


IGGPMGO 


IGGPEXPD, IGGPMBGO, 
IGGPMGO, IGGPSHNK 


IGGPSNVC 


IGGPSCNF 
IGGPSCNF 
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Procedure Calls Directory (continued) 


External procedures called 


Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
Internal 
IGGPGREP IGGPGREC (BA) — 
IGGPLOC2 IGGPGVAL (BA) IGGPGREP, IGGPSHIN 
IGGPSCNF  IGGPGREC (BA), IGGPSMFG (B3), IGGPLOC2, IGGPUPGD 
IGGPTSTS (BA) 
IGGPSHIN — — 
IGGPUPGD IGGPGET (BI), IGGPGVAL (BA) = 
IGGOCLAO 
External 
IGGOCLAO — —_ 
IGGOCLAI1 
External 
IGGOCLAI1 IGGOCLC9 — 
IGGOCLA2 
External 
IGGPGDGL — IGGPGFND, IGGPGGE, 
IGGPGMIN, IGGPGRGN, 
IGGPGTAB 
IGGPGLOC IGGPDBVC (AM), IGGPGET (BI), IGGPGLCN 
IGGPSC2 (AH) 
Internal 
IGGPGFND — = 
IGGPGGE IGGPEXT (AZ), IGGPGET (BI) — 
IGGPGLCN — = 
IGGPGMIN') — — 
IGGPGRGN — — 
IGGPGTAB IGGPEXT (AZ), IGGPSLEL (AM) — 
IGGOCLA3 
External 
IGGPCSCP IGGPCSDO (AH) IGGPCPCC, IGGPDOG, 
IGGPGPCC 
IGGPCVX — a 
IGGPDOG IGGPARFS (AT), IGGPCKAU (BM), IGGPCVX, IGGPGRE, 
IGGPGET (BI) IGGPRPLF, IGGPRPLM 
IGGPGPCC — ae 
IGGPGRE —_IGGPGET (BI) — 
IGGPRPLF — _ 
IGGPRPLM IGGPCCBC (A9) IGGPSRPL 
Internal 
IGGPCPCC — — 
IGGPSRPL — eae 


Directory 249 


Page of SY26-3826-3 
Revised July 28, 1978 
By TNL SN26-0912 


Procedure Calls Directory (continued) 


External procedures called 
Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
IGGOCLA4 
External 
IGGPDEFB IGGPAXCI (AG), IGGPPAD (AG), = 
IGGPSMFA (BV) 


IGGPDGDS__IGGPARFS (AT), IGGPDEL (BG), 
IGGPEXT (AZ), IGGPGET (BI), 


IGGPBCFA, IGGPBCFC, 
IGGPBCFD, IGGPGCOM, 


IGGPMOD (AV), IGGPPUPC (AG) IGGPGEXP 
IGGPRACG (DC) 
IGGPERUG = IGGPEXT (AZ), IGGPMOD (AV) IGGPBCFC, IGGPBCFD, 
IGGPGCOM 
Internal 
IGGPBCFA — IGGPCCFB 
IGGPBCFC — IGGPCCFB 
IGGPBCFD — — 
IGGPCCFD — = 
IGGPGCOM — — 
IGGPGEXP — — 
IGGOCLAS 
External 


IGGPDALL IGGPEXT (AZ), IGGPGET (BI) 


IGGPDELB IGGPARFS (AT), IGGPDEL (BG), 
IGGPEXT (AZ), IGGPGET (BI), 
IGGPMOD (AV), IGGPPDE (AG), 


IGGPCCFM, IGGPDONE 


IGGPBCFE, IGGPDGBC, 
IGGPPUNT 
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IGGPSMFS (BV) 
IGGPDELX IGGPGET (BI) IGGPCCFM, IGGPDONE 
Internal 
IGGPBCFE — — 
IGGPCCFM — _— 
IGGPDGBC IGGPARFS (AT) — 
IGGPDONE  IGGPEXT (AZ), IGGPGET (BI), IGGPCCFM 
IGGPMOD (AV), IGGPPDE (AG), 
IGGPSMFS (BV) 
IGGPPUNT — — 
IGGOCLA6 
External 
IGGPBJFB IGGPARFS (AT) — 
IGGPCBPT — — 
IGGPCRTC — — 
IGGPDFS2 — IGGPCDSD, IGGPCSDG, 


IGGPCSHG 


Procedure Calls Directory (continued) 


Calling 
Module and its 


Procedures 


Internal 

IGGPCDSD 
IGGPCSDG 
IGGPCSHG 
IGGPDSMD 


IGGOCLA7 


External 
IGGPDEMV 
IGGPDF4T 


IGGPDUSC 
IGGPDVMV 
IGGPMCRA 
IGGPVMSC 


Intemal 
IGGPDEDD 
IGGPDESH 
IGGPDEVG 


IGGPDMSG 
IGGPRCTV 


IGGPSET 
IGGPRCTV 


IGGOCLA8 


Extemal 
IGGPDFRS 
Internal 
IGGPDFRE 


IGGOCLA9 


External 
IGGPCCBC 
IGGPCMRR 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPSALL (AR) 


IGGPMOD (AV) 


IGGPEXT (AZ) 


IGGPDLXT (BG), 
IGGPF4DQ (BU), IGGPF4RD (BU), 
IGGPF4WR (BU), IGGPPUPC (AG) 


IGGPDLXT (BG) 


IGGPGET (BI), IGGPSSCR (BF), 
IGGPAREFS (AT) 


IGGPMOD (AV) 
IGGPMOD (AV) 


IGGPARFS (AT), IGGPEXT (AZ), 
IGGPDLXT (BG), IGGPMOD (AV) 


IGGPEXT (AZ), IGGPMOD (AV) 


IGGPF4DQ (BU), IGGPF4RD (BU), 
IGGPF4WR (BU) 


IGGPARFS (AT) 


IGGPAREFS (AT) 


IGGPCCCR (AG), IGGPRPLF (A3) 


Page of SY26-3826-3 
Revised July 28, 1978 
By TNL SN26-0912 


Internal procedures called 
(Procedures within the module) 


IGGPDSMD 
IGGPDSMD 
IGGPDSMD 


IGGPSET 


IGGPDVMV 


IGGPDEDD, IGGPDMSG, 
IGGPDESH, IGGPDEVG, 
IGGPDUSC 


IGGPSET 
IGGPSET 
IGGPDVMV, IGGPSET 


IGGPRCTV, IGGPSET 


IGGPCRPL, IGGPDDBO, 
IGGPFRES, IGGPPDO 
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Procedure Calls Directory (continued) 


External procedures called 
Calling (Procedures outside the module) 
Module and its (Abbreviated module name in 
Procedures parentheses is IGGOCLxx) 


Internal procedures called 
(Procedures within the module) 


Internal 
IGGPCRPL — IGGPCCBC 


IGGPDDBO IGGPCCCR (AG), IGGPCDVR (AT), — 
IGGPRPLF (A3) 


IGGPFRES — IGGPGNTE 

IGGPGNTE — = 

IGGPPDO — — 
IGGOCLBA 

External 


IGGPGREC IGGPGET (BI), IGGPPREC (AW), — 
IGGPSMFG (B3) 


IGGPGVAL IGGPXVAL (BS) 
IGGPTSTS — 


IGGPGREC, IGGPLVAL 


IGGPGVAL, IGGPTCMP, 
IGGPGREC 


Internal 

IGGPCKLC — == 
IGGPLVAL — IGGPCKLC 
IGGPTCMP — — 
IGGOCLBB 

External 


IGGPUPDE IGGPEXT (AZ), IGGPGET (BI), 
IGGPINIT (BC), IGGPSMFA (BV), 
IGGPSMEL (BV), IGGPSVOL (BC), 


IGGPCEXT, IGGPCSAL, 
IGGPMEXT, IGGPMVOL, 
IGGPSSWD, IGGPUALL 


Internal 
IGGPCEXT 
IGGPCSAL 


IGGPMEXT 
IGGPMVOL 
IGGPSSWD 


IGGPUALL 


IGGOCLBC 


External 
IGGPINIT 
IGGPSVOL 


IGGOCLBD 
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External 


IGGPALT 


IGGPTNXO (BI), IGGPTXO (BI) 


IGGPARFS (AT), IGGPSALL (AR), 
IGGPSPAC (BP) 


IGGPMOD (AV) 
IGGPMOD (AV) 


IGGPGET (BI), IGGPINIT (BC), 
IGGPSVOL (BC) 


IGGPGET (BI) 


IGGPEXT (AZ) 
IGGPEXT (AZ) 


IGGPALMD (BN), IGGPALVL (BE), 
IGGPANVV (BE), IGGPARFS (AT), 
IGGPAUPG (B2), IGGPGET (BI), 
IGGPPUPC (AG), IGGPSMF (B3), 
IGGPSMFA (BV), IGGPSMFG (B3) 


IGGPCEXT, IGGPMEXT, 


IGGPMVOL 


IGGPALNM 


Procedure Calls Directory (continued) 


Calling 
Module and its 


Procedures 


Internal 
IGGPALF1 
IGGPALGV 
IGGPALNM 


IGGPALSV 


IGGOCLBE 


External 
IGGPALEC 
IGGPALVL 


IGGPANVV 
Internal 
IGGPALAE 
IGGPALBC 
IGGPALIX 
IGGPALSA 
IGGPALVA 


IGGOCLBF 


External 
IGGPSSCR 


IGGOCLBG 


External 
IGGPDEL 


IGGPDEXA 
IGGPDLXT 
IGGPDOPN 
Internal 
IGGPDDCK 
IGGPERAS 


IGGOCLBH 


External 
IGGPDAVO 
IGGPDEFA 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPARFS (AT) 
IGGPARFS (AT), IGGPEXT (AZ) 


IGGPALRN (DD), IGGPGET (BJ), 
IGGPPAD (AG), IGGPPDE (AG), 
IGGPQNQC (AH), IGGPSMFR (BV) 


IGGPARFS (AT) 


IGGPGET (BI) 


IGGPALVR (BN), IGGPARFS (AT), 
IGGPEXT (AZ), IGGPVRD (BN) 


IGGPDAVO (BH), IGGPMOD (AV) 


IGGPEXT (AZ), IGGPGET (BI) 
IGGPMOD (AV), IGGPSALL (AR) 
IGGPEXT (AZ) 


IGGPBMR (BR) 


IGGPDALL (A6), IGGPDCLS (B5), 
IGGPDEAX (B5), IGGPDEMV (A7), 
IGGPDEPT (B5), IGGPDIAX (B5), 
IGGPDIPT (B5), IGGPDUPG (B5), 
IGGPGET (BI), IGGPMCRA (A7), 
IGGPSMFS (BV), IGGPVMSC (A7) 


IGGPEXT (AZ) 
IGGPARFS (AT) 


IGGPRPLF (A3), IGGPRPLM (A3) 


IGGPMOD (AV) 


IGGPDGDS (A4), IGGPDUND (B8), 
IGGPSMFA (BV) 
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Internal procedures called 
(Procedures within the module) 


IGGPALGV, IGGPALSV 


IGGPALF1 


IGGPALIX 
IGGPALBC, IGGPALVA 


—_—aee 


IGGPALBC 
IGGPALBC, IGGPALEC 


IGGPALBC, IGGPALAE, 
IGGPALSA 


IGGPDDCK, IGGPDEXA, 
IGGPDLXT, IGGPDOPN, 
IGGPERAS 


IGGPDLXT 


IGGPDLXT 
IGGPDLXT 


— 


IGGPDAIN, IGGPDAVO 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


Internal 
IGGPDAIN 
IGGPDANL 


IGGOCLBI 


Extemal 
IGGPGET 
IGGPTNXO 
IGGPTXO 


IGGPUCRS 
Internal 
IGGPUCCT 
IGGPUCVT 
IGGPXIO 


IGGOCLBJ 


External 
IGGPGDSP 
Internal 


IGGPGUDS 


IGGOCLBK 


External 
IGGPLDCS 
IGGPLSP 


Internal 

IGGPLBVC 
IGGPLDAS 
IGGPLDCE 
IGGPLEMP 
IGGPLSMP 
IGGPLSMS 


IGGOCLBL 


Extemal 


IGGPDELS 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPAXCI (AG) 


IGGPRAG (BO) 


IGGPARFS (AT), IGGPEXT (AZ), 
IGGPMOD (AV) 


IGGPIORA (AG) 


IGGPEXT (AZ) 


IGGPGET (BI) 


IGGPGET (BI), IGGPSMFL (BV) 


IGGPEXT (AZ) 


— 


IGGPEXT (AZ) 


Internal procedures called 
(Procedures within the module) 


IGGPDANL 


— 


IGGPXIO, IGGPUCCT 


IGGPUCVT, IGGPGET 


IGGPGUDS 


IGGPLDCE 


IGGPLBVC, IGGPLDCS, 
IGGPLEMP, IGGPLSMP 


— 


IGGPLDAS, IGGPLSMS 


IGGPLBVC 


IGGPLDAS 


IGGPDLCD, IGGPDLEX 
IGGPDLSC, IGGPDLSH, 
IGGPDLVC, IGGPDLVM 


IGGPDEL (BG), IGGPDFM1 (AI), = 
IGGPF4RD (BU), IGGPF4WR (BU), 
IGGPGET (BI), IGGPMOD (AV), 
IGGPRAOP (AD) 


IGGPDLVM — IGGPVMV 
IGGPDUCB — — 


IGGPDLET 
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IGGPF4WR (BU) 
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By TNL SN26-0912 
Procedure Calls Directory (continued) 
External procedures called 
Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
Internal 
IGGPDLCD  IGGPEXT (AZ) — 
IGGPDLEX — — 
IGGPDLMF  IGGPLSP (Bk) — 
IGGPDLSC — — 
IGGPDLSH IGGPMOD (AV) = 
IGGPDLVC  IGGPEXT (AZ) IGGPDLET, IGGPDLMF 
IGGPVMV — — 
IGGOCLBM 
External 
IGGPCKAU  IGGPINMD (B6), IGGPSPSC (Bé) IGGPBSGT, IGGPCKEX, 
IGGPLVST, IGGPPWGT, 
IGGPPWVR 
Internal 
IGGPBSGT IGGPGET (BI) _ 
IGGPCKEX IGGPEXT (AZ), IGGPRACS (DC) — 
IGGPCLGT IGGPEXT (AZ), IGGPGET (BI) IGGPBSGT, IGGPCKEX 
IGGPRACK (DC) 
IGGPLVST — = 
IGGPPWGT IGGPGET (BI), IGGPRPLF (A3), IGGPCKEX 
IGGPRPLM (A3), IGGPWTSO (B6) 
| IGGPPWVR_ IGGPRACT (DC), IGGPRACV (DC) IGGPBSGT, IGGPCKCC, 
IGGPCKEX, IGGPCLGT 
IGGOCLBN 
External 
IGGPALMD — IGGPARFS (AT), IGGPMOD (AV) IGGPALBT 
IGGPALSV IGGPARFS (AT) — 
IGGPALVR IGGPALEC (BE), IGGPEXT (AZ), IGGPALPL, IGGPALVE, 
IGGPMOD (AV) IGGPALVO 
IGGPVRD IGGPGET (BI) IGGPVRCV 
Internal 
IGGPACHR — — 
IGGPALBT — — 
IGGPALPL — -_ 
IGGPALVE  IGGPGET (BI), IGGPMOD (AV) IGGPALPL 
IGGPALVO — — 
IGGPVRCV  IGGPF4DQ (BU), IGGPF4RD (BU), IGGPACHR 
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Procedure Calls Directory (continued) 


External procedures called 


Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
IGGOCLBO 
External 
IGGPRAG —_ IGGPRAOR, IGGPRAX, 
IGGPXRIO 
IGGPRAPA  IGGPARFS (AT), IGGPPAD (AG), IGGPRAOR, IGGPRAPC, 
IGGPRAPV (DA) IGGPRARA, IGGPRAX 
IGGPRAPD IGGPRAPV (DA) IGGPRAOR, IGGPRARC, 
IGGPRAX, IGGPXRIO 
IGGPRAPU  IGGPRAPV (DA) IGGPRAOR, IGGPRAX, 
IGGPXRIO 
IGGPRARC — IGGPXRIO 
IGGPRASC — IGGPRAOR, IGGPRARA, 
IGGPRARC, IGGPRAX 
IGGPXRIO — IGGPRAEA 
Internal 
IGGPRACC — IGGPXRIO 
IGGPRAEA IGGPEMIO (AF), IGGPEMSG (AF) — 
IGGPRAOR IGGPRAOP (AD) = 
IGGPRAPC IGGPARFS (AT) — 
IGGPRARA — IGGPRACC, IGGPRARC, 
IGGPXRIO 
IGGPRAX = IGGPRACC 
IGGOCLBP 
External 
IGGPRET1 — — 


IGGPSPAC IGGPF4DQ (BU), IGGPF4RD (BU), IGGPDALL, IGGPDEXT, 
IGGPF4WR (BU), IGGPISCI (AG), IGGPINEX, IGGPOBTN, 


IGGPPUPC (AG) IGGPSRH1, IGGPSRH2, 
IGGPWRIT 

Internal 

IGGPDALL — IGGPGNAM 
IGGPDEXT — IGGPGNAM 
IGGPGNAM — — 

IGGPINEX — — 

IGGPOBTN — — 


IGGPSRH1 IGGPEXT (AZ) — 

IGGPSRH2 IGGPEXT (AZ) = 

IGGPWRIT IGGPMOD (AV) — 
IGGOCLBQ 

External 


IGGPLSTC IGGPCKAU (BM), IGGPEXT (AZ), — 
IGGPGET (BI) 
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Procedure Calls Directory (continued) 


Calling 


Module and its 


Procedures 


IGGOCLBR 


External 


IGGPBMR 


Internal 
IGGPGETM 
IGGPPART 
IGGPPUTM 


IGGOCLBS 


External 
IGGPXEXT 
IGGPXVAL 


Internal 
IGGPXEXS 
IGGPXVOL 


IGGOCLBT 


External 
IGGPXDGO 


IGGPXEL2 


IGGPXLT2 
IGGPXMOD 
Internal 


IGGPCSMP 


IGGOCLBU 


External 

IGGPF4DQ 
IGGPF4RD 
IGGPF4WR 


IGGOCLBV 


External 


IGGPSMFA 


IGGPSMFF 
IGGPSMFL 
IGGPSMFR 
IGGPSMFS 
IGGPSMFZ 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPGET (BI) 


IGGPPUPC (AG) 


IGGPBMR (BR), IGGPGREC (BA), 
IGGPGVAL (BA), IGGPSGOP (AV) 


.IGGPGREC (BA), IGGPGVAL (BA) 


IGGPADGO (AW), IGGPBMR (BR), 
IGGPGREC (BA), IGGPGVAL (BA) 


IGGPBMR (BR), IGGPDEL2 (AV), 
IGGPGREC (BA), IGGPGVAL (BA) 


IGGPALT2 (AX) 


IGGPAOCI (AG), IGGPPUPC (AG) 


IGGPGET (BI) 


IGGPARFS (AT) 
IGGPGET (BI), IGGPLDCS (BK) 
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Internal procedures called 
(Procedures within the module) 


IGGPGETM, IGGPPART, 
IGGPPUTM 


IGGPPUTM 


IGGPXVOL 


IGGPCSMP 


IGGPF4DQ 
IGGPF4DQ 


IGGPSMFC, IGGPSMFD, 
IGGPSMFE, IGGPSMFF 


IGGPSMFC 
IGGPSMFC 
IGGPSMFC, IGGPSMFE 


Directory 257 


Procedure Calls Directory (continued) 


External procedures called 


Calling (Procedures outside the module) 
Module and its (Abbreviated module name in Internal procedures called 
Procedures parentheses is IGGOCLxx) (Procedures within the module) 
Internal 
IGGPSMFC  IGGPARFS (AT) — 
IGGPSMFD  IGGPARFS (AT) IGGPSMFZ 
IGGPSMFE IGGPARFS (AT) IGGPSMFM 
IGGPSMFM — IGGPGET (BI) IGGPSMFP 
IGGPSMFP — = 
I1GGOCLBW 
External 
IGGPDEIN IGGPGVAL (BA) IGGPRISE, IGGPSINK, 
IGGPSNK2 
Internal 


IGGPDOWN_  IGGPAXCI (AG), IGGPEXPD (AX), — 
IGGPGNEX (AW), IGGPGVAL (BA), 
IGGPPREC (AW), IGGPSHNK (AX) 


IGGPRISE IGGPAXCI (AG), IGGPGVAL (BA), IGGPSINK, IGGPUPUP 
IGGPPREC (AW), IGGPSHNK (AX) 


IGGPSINK IGGPEXPD (AX), IGGPSHNK (AX) — 


IGGPSNK2 IGGPAXCI (AG), IGGPGREC (BA), IGGPDOWN 
IGGPPDE (AG), IGGPPREC (AW), 


IGGPSMF (B3) 
IGGPUPUP — — 
IGGOCLBX 

External 

IGGPDCIM — = 

IGGPDSPC — IGGPDCCC, IGGPDCCO, 
IGGPDDCE 

Internal 

IGGPDCCC — IGGPDCID, IGGPDCIM, 
IGGPDCPT, IGGPDPBI, 
IGGPITER 

IGGPDCCI — IGGPDPBI 

IGGPDCID — IGGPDCIM, IGGPMAXA 

IGGPDCIM — — 

IGGPDCPT — — 

IGGPDDCE  IGGPGET (BI) — 

IGGPDPBI — — 

IGGPITER — —_ 

IGGPMAXA — — 

IGGOCLBY 
External 
IGGPDRSP — IGGPDATA, IGGPDCIS, 


IGGPDDRT, IGGPDDSA, 
IGGPDDTC, IGGPDISA 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


Internal 
IGGPDATA 
IGGPDCIS 
IGGPDDRT 
IGGPDDSA 


IGGPDDTC 
IGGPDISA 


IGGOCLBZ 


External 


IGGPCONV 


IGGPGALO 
IGGPVALI 


IGGOCLBO 


Extemal 
IGGPDCCO 
Internal 
IGGPDCCI 
IGGPDPBI 


IGGOCLBI 


External 


IGGPUADD 


IGGPUDEL 


Internal 
IGGPUCOM 
IGGPUEND 


IGGOCLB2 


External 
IGGPALPG 
IGGPAUPG 


Internal 


IGGPAEXA 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPF4RD (BU), IGGPF4WR (BU), 
IGGPMOD (AV), IGGPPUPC (AG), 
IGGPRCCR (AG), IGGPRPLF (A3), 


IGGPSCAT (AH) 


IGGPPSPC (BX) 


IGGPAXC]I (AG), IGGPEXT (AZ), 
IGGPGET (BI), IGGPMOD (AV), 
IGGPPAD (AG), IGGPPDE (AG) 


IGGPEXT (AZ), IGGPGET (BI), 
IGGPMOD (AV), IGGPPDE (AG) 


IGGPEXT (AZ), IGGPGET (BI) 
IGGPGET (BI) 


IGGPARFS (AT), IGGPEXT (AZ), 


IGGPUADD (B1), IGGPUDEL (B1) 
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Internal procedures called 
(Procedures within the module) 


IGGPDATA, IGGPDDRT, 
IGGPDDTC 


IGGPGALO, IGGPVALI 


IGGPDCCI, IGGPDPBI 


IGGPDPBI 


IGGPUCOM, IGGPUEND 


IGGPUCOM, IGGPUEND 


IGGPAEXA 
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Procedure Calls Directory (continued) 


External procedures called - 


Calling (Procedures outside the module) 


Module and its (Abbreviated module name in Intermal procedures called 
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Procedures parentheses is IGGOCLxx) (Procedures within the module) 
IGGOCLB3 
External 
IGGPSMF — _ 
IGGPSMFG  IGGPARFS (AT), IGGPSMFZ (BV) — ‘ 
IGGOCLB4 
External 7 
IGGPDCRA IGGPMODI (DA), IGGPWCAT (DA), IGGPCACB, IGGPCCIO, 
IGGPWCRA (DA) IGGPCHIU, IGGPCI15, 
IGGPCRPL, IGGPCXWA, 
IGGPDCXT, IGGPFMT4, 
IGGPOCRA, IGGPRDEF, 
IGGPSBAL, IGGPSTRG 
Internal 
IGGPCACB — — 
IGGPCCIO.  — — 
IGGPCHIU. — — 
IGGPCI15 — =_ 
IGGPCRPL — — 
IGGPCXWA — = 
IGGPDCXT IGGPARFS (AT) = J 
IGGPFMT4 IGGPF4RD (BU), IGGPF4WR (BU) — 
IGGPOCRA — — 
IGGPRDEF IGGPDEFS (AQ) — 
IGGPSBAL  IGGPSALL (AR) = 
IGGPSTRG  IGGPARFS (AT) IGGPRDEF, IGGPSBAL 
IGGOCLBS5 
External 
IGGPDCLS IGGPDLXT (BG), IGGPDUND (B8), — 
IGGPGET (BI), IGGPPDE (AG), 
IGGPROBD (DD), IGGPSMFS (BV), 
IGGPVMSC (A7) : 
IGGPDEAX IGGPDLXT (BG), IGGPGET (BI) IGGPDBMD, IGGPDEXB, 


IGGPDIPT, IGGPDUPG 


IGGPDEPT IGGPDLXT (BG), IGGPGET (BI), IGGPDBMD » 
IGGPPDE (AG), IGGPRPTH (DD), 
IGGPSMEFS (BV) 
IGGPDIAX IGGPDEXA (BG), IGGPDLXT (BG), IGGPDBMD, IGGPDCLS, 
IGGPDOPN (BG), IGGPGET (BI) IGGPDEXB, IGGPDIPT, 
IGGPDUPG 
IGGPDIPT IGGPDLXT (BG), IGGPGET (BI), IGGPDBMD, IGGPDEXB 
IGGPPDE (AG), IGGPSMFS (BV) 
IGGPDUPG IGGPDLXT(BG),IGGPUADD (B1), — 


IGGPUDEL (B1) 


Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


Internal 
IGGPDBMD 
IGGPDEXB 


IGGOCLB6 


External 
IGGPCKCC 
IGGPINMD 
IGGPSPSC 
IGGPWTSO 
Internal 


IGGPGTSO 


IGGOCLB7 


External 


IGGPRUS 


Internal 
IGGPFRWK 


IGGOCLB8 


External 
IGGPCNBO 
IGGPDFBO 


IGGPDUND 
Internal 
IGGPBCAN 
IGGPBDSH 
IGGPBDSS 
IGGPBNUN 
IGGPBSCR 
IGGPDFBI 


IGGOCLB9 


External 
IGGPPAIX 


IGGPPATH 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPDLXT (BG), IGGPMOD (AV) 
IGGPDLXT (BG), IGGPEXT (AZ) 


IGGPGET (BI) 
IGGPGET (BI) 
IGGPCKEX (BM), IGGPGET (BI) 


IGGPRPLF (A3), IGGPRPLM (A3) 


IGGPARFS (AT), IGGPEXT (AZ),’ 
IGGPGET (BI), IGGPLOC (AZ), 
IGGPMOD (AV), IGGPSSCR (BF), 
IGGPTNXO (BI), IGGPTXO (BI) 


IGGPARFS (AT), IGGPGET (BI), 
IGGPLOC (AZ) 


IGGPGET (BI), IGGPMOD (AV) 


IGGPARFS (AT), IGGPDUND (B8), 
IGGPGET (BI), IGGPVMSC (A7) 


IGGPGET (BI), IGGPPDE (AG) 


IGGPGET (BI), IGGPMOD (AV) 
IGGPMOD (AV) 
IGGPMOD (AV) 
IGGPSSCR (BF) 


IGGPDRDA (AN), IGGPDUND (B8), 
IGGPPSEM (AN) 
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Internal procedures called 
(Procedures within the module) 


IGGPGTSO 


IGGPFRWK 


IGGPDFBI 


IGGPBCAN, IGGPBDSH, 
IGGPBDSS, IGGPBNUN, 
IGGPBSCR, IGGPDFBI 


IGGPDEUN 


IGGPDCBG, IGGPIGDC, 
IGGPMODC, IGGPPRPW, 
IGGPRGBC 


IGGPBAMC, IGGPBAWP, 
IGGPCGGC, IGGPIGDC, 
IGGPRPW, IGGPSCRG, 
IGGPWSMF 
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Procedure Calls Directory (continued) 


Calling 
Module and its 
Procedures 


Internal 
IGGPBAMC 
IGGPBAWP 


IGGPCGGC 
IGGPDCBG 
IGGPEXGC 
IGGPIGDC 
IGGPINAE 
IGGPINBE 
IGGPMODC 


IGGPPRPW 
IGGPRGBC 
IGGPRPW 
IGGPSCRG 
IGGPWSMF 
IGGOCLCA 
External 
IGGOCLCA 
IGGOCLC9 
External 
IGGOCLC9 
Internal 
BLDCCA 
IGGPRCU 


IGGOCLDA 
External 
IGGPMODI 
IGGPRAPV 


IGGPWCAT 
IGGPWCRA 
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External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPMOD (AV) 


IGGPAOCI (AG), IGGPMOD (AV), 
IGGPPDE (AG) 


IGGPEXT (AZ) 
IGGPDCCE (AN) 
IGGPEXT (AZ), IGGPGET (BI) 


IGGPEXT (AZ) 


IGGPAOCI (AG), IGGPGET (BD), 
IGGPMOD (AV) 


IGGPCKAU (BM), IGGPGET (BI) 
IGGPMOD (AV) 


IGGPSMFA (BV) 


IGGPACDV (AB), IGGPRET1 (BP) 


IGGPARFS (AT), IGGPEMSG (AF), 
IGGPRARC (BO), IGGPRPLF (A3) 


IGGPMOD (AV) 


IGGPF4DQ (BU), IGGPF4RD (BU), 
IGGPF4WR (BU), IGGPXIO (AG) 


IGGPARFS (AT), IGGPPAD (AG) 
IGGPXRIO (BO) 


Internal procedures called 
(Procedures within the module) 


IGGPINAE, IGGPINBE 


IGGPEXGC 


BLDCCA, IGGPRCU 


Procedure Calls Directory (continued) 


Calling 


Module and its 


Procedures 


IGGOCLDD 


External 
IGGPALRI 
IGGPALRN 
IGGPRDEF 
IGGPRDEL 
IGGPRDLC 
IGGPRFDC 
IGGPRPTH 
IGGPROBD 


IGGOCLDC 


External 
IGGPRACG 
IGGPRACT 
IGGPRACV 
Internal 
IGGPRACE 
IGGPRACK 
IGGPRACS 
IGGPRACX 


External procedures called 
(Procedures outside the module) 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPGALO (BZ) 


IGGPBSGT (BM) 


IGGPEXT (AZ) 


IGGPGRE (A3) 
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Internal procedures called 
(Procedures within the module) 


IGGPRDEL 
IGGPRDEL 
IGGPRDEL 
IGGPRDEL 


IGGPRACK 
IGGPRACK 


IGGPRACK, IGGPRACX 


IGGPRACS 
IGGPRACE 
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Procedure Called-By Directory 


This table lists procedures that call an OS/VS2 Catalog Management 
procedure. See “Procedure Calls Directory” to determine the calling 
procedures within the module. 


Called module 
and its external 
procedures 


IGGOCLAA 
Procedure: 
IGGPSLEN 

IGGOCLAB 
Procedure: 
IGGPACDV 

IGGOCLAC 
Procedure: 
IGGPMCO 

IGGOCLAD 
Procedures: 
IGGPMCO2 
IGGPRAOP 

IGGOCLAE 
Procedure: 
IGGPDCME 
IGGPMEBM 

IGGOCLAF 
Procedures: 
IGGPDELC 
IGGPEMIO 
IGGPEMSG 

IGGOCLAG 
Procedures: 


IGGPAOCI 


IGGPAXCI 


IGGPCCCR 


IGGPIORA 
IGGPISCI 
IGGPPAD 


IGGPPDE 


Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPSLOC (AM) 


IGGOCLC9 (C9) 


IGGPACDV (AB) 


IGGPDCOC (AE), IGGPMCO (AC) 
IGGPDLET (BL), IGGPRAOR (BO) 


IGGPDEFC (AS) 
IGGPDCSP (AS) 


IGGPCDVR (AT) 
IGGPIORA (AG), IGGPRAEA (BO) 
IGGPIORA (AG), IGGPRAEA (BO), IGGPRCU (C9) 


IGGPBAWP (B9), IGGPCSMP (BT), IGGPDCCE (AN), 
IGGPMODC (B9) 


IGGPADGO (AW), IGGPAGOP (AW), IGGPDAIN (BH), 
IGGPDCPC (AP), IGGPDEFB (A4), IGGPDEFS (AQ), 
IGGPDEFX (AO), IGGPDOWN (BW), IGGPMBGO (AX), 
IGGPMVAR (AX), IGGPRISE (BW), IGGPSNK2 (BW) 


IGGPCMRR (A9), IGGPCONV (BZ), IGGPDDBO (A9), 
IGGPDEFC (AS), IGGPDELC (AF) 


IGGPXIO (BI) 
IGGPDEFS (AQ), IGGPSALL (AR), IGGPSPAC (BP) 


IGGPALNM (BD), IGGPDCCE (AN), IGGPDCPC (AP), 
IGGPDEFB (A4), IGGPDEFS (AQ), IGGPPREC (AW), 
IGGPRAPA (BO), IGGPUADD (B1), IGGPWCAT (DA) 


IGGPALNM (BD), IGGPBAWP (B9), IGGPDCLS (B5), 
IGGPDEFX (AO), IGGPDELB (AS), IGGPDELC (AF), 
IGGPDEL2 (AV), IGGPDEPT (B5), IGGPDIPT (B5), 
IGGPDONE (A5), IGGPDUND (B8), IGGPSNK2 (BW), 
IGGPUADD (B1), IGGPUDEL (B1) 
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Procedure Called-By Directory (continued) 


Called module 


and its external 


procedures 


IGGPPUPC 


IGGPRCCR 
IGGPXIO 


IGGOCLAH 


Procedures: 
IGGPCSDO 
IGGPQNQC 
IGGPSCAT 


IGGPCS2 


IGGOCLAI 


Procedures: 
IGGPDFM1 
IGGPFDSP 


IGGOCLAJ 


Procedure: 


IGGPDBDI 


IGGOCLAK 


Procedure: 


IGGPDCMB 


IGGOCLAL 


Procedures: 
IGGPDEF 
IGGPDTIM 


IGGOCLAM 


Procedures: 
IGGPDBVC 
IGGPSLEL 


IGGPSLOC 


IGGOCLAN 


Procedures: 
IGGPDCCE 
IGGPDRDA 
IGGPDSCB 
IGGPPSEM 


IGGOCLAP 


Procedure: 


IGGPDCDA 


Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPALT (BD), IGGPCONV (BZ), IGGPCSMP (BT), 
IGGPDF4T (A7), IGGPDGDS (A4), IGGPFDSP (Al), 
IGGPPREC (AW), IGGPPUTM (BR), IGGPSPAC (BP) 


IGGPCONV (BZ) 
IGGPDCPR (AE), IGGPDELC (AF), IGGPRAPV (DA) 


IGGPCSCP (A3) 
IGGPALNM (BD), IGGPDEDE (AL) 


IGGPACDV (AB), IGGPCDVR (AT), IGGPCONV (BZ), 
IGGPDEFS (AQ), IGGPDELC (AF) 


IGGPGLOC (A2) 


IGGPDELT (BL) 
IGGPDELC (AF) 


IGGPDSCB (AN) 


IGGPDBDI (AJ) 


IGGPCDVR (AT) 
IGGPDBDI (AJ), IGGPDEFS (AQ) 


IGGPDELC (AF), IGGPGLOC (A2) 


IGGPGTAB (A2), IGGPSLEN (AA), IGGPSLR (AA), 
IGGPSLY (AA) 


IGGPACDV (AB) 


IGGPDCBG (B9), IGGPDCPC (AP) 
IGGPPAIX (B9) 
IGGPDEF (AL) 
IGGPPAIX (B9) 


IGGPDSCB (AN) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLAQ 
Procedure: 


IGGPDEFS 


IGGOCLAR 
Procedure: 
IGGPSALL 


IGGOCLAS 
Procedures: 
IGGPDCRC 
IGGPDEFC 

IGGOCLAT 
Procedures: 


IGGPARFS 


IGGPCDVR 
IGGOCLAU 
Procedure: 


IGGPSALS 


Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPCDVR (AT), IGGPDCSP (AS), IGGPDSPO (AJ), 
IGGPRDEF (B4) 


IGGPALSA (BE), IGGPCDSD (A6), IGGPCSAL (BB), 
IGGPDCNV (AJ), IGGPDCSP (AS), IGGPDSPO (AJ), 
IGGPSBAL (B4) 


IGGPDCME (AE) 
IGGPDSCB (AN) 


IGGPALF! (BD), IGGPALGV (BD), IGGPALMD (BN), 
IGGPALSV (BN), IGGPALT (BD), IGGPALVL (BE), 
IGGPAUPG (B2),; IGGPBJFB (A6), IGGPCSAL (BB), 
IGGPDBCV (AK), IGGPDBVO (AK), IGGPDCDS (AF), 
IGGPDCNV (AJ), IGGPDCOC (AE), IGGPDCSP (AS), 
IGGPDCXT (B4), IGGPDEFS (AQ), IGGPDELB (AS), 
IGGPDEVG (A7), IGGPDEXD (AJ), IGGPDFBO (B8), 
IGGPDFRE (A8), IGGPDFRS (A8), IGGPDGBC (AS), 
IGGPDGDS (A4), IGGPDLXT (BG), IGGPDMOP (AK), 
IGGPDOG (A3), IGGPDSEX (AJ), IGGPDSXT (AQ), 
IGGPFDSP (AI), IGGPFRWK (B7), IGGPTXO (BD), 
IGGPRAPA (BO), IGGPRAPC (BO), IGGPRCU (C9), 
IGGPRUS (B7), IGGPSMFC (BV), IGGPSMFD (BV), 
IGGPSMFE (BV), IGGPSMFF (BV), IGGPSMFG (B3), 
IGGPSTRG (B4), IGGPVMSC (A7), IGGPWCAT (DA) 


IGGPACDV (AB), IGGPDDBO (A9) 


IGGPSALL (AR) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLAV 
Procedures: 
IGGPDEL2 
IGGPMOD 


IGGPPUPD 
IGGPSGOP 
IGGOCLAW 

Procedures: 
IGGPADGO 
IGGPGNEX 
IGGPIGOP 
IGGPPREC 


IGGOCLAX 
Procedures: 
IGGPALT2 
IGGPDGO 
IGGPDGOP 
IGGPEXPD 
IGGPMGO 
IGGPSHNK 

IGGOCLAY 
Procedure: 


IGGPSCNC 
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Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPXEL2 (BT) 


IGGPALMD (BN), IGGPALSA (BE), IGGPALVE (BN), 
IGGPALVR (BN), IGGPANVV (BE), IGGPBAMC (B9), 
IGGPBAWP (B9), IGGPBCAN (B8), IGGPBCFI (AO), 
IGGPBDSH (B8), IGGPBDSS (B8), IGGPCNBO (B38), 
IGGPCONV (BZ), IGGPDAVO (BH), IGGPDBMD (B5), 
IGGPDCME (AE), IGGPDEDD (A7), IGGPDEFX (AO), 
IGGPDELB (A5), IGGPDESH (A7), IGGPDEVG (A7), 
IGGPDGDG (A4), IGGPDLET (BL), IGGPDLSH (BL), 
IGGPDMOP (A6), IGGPDMSG (A7), IGGPDONE (AS), 
IGGPDSMD (A6), IGGPERUG (A4), IGGPFDSP (AD), 
IGGPMEXT (BB), IGGPMODC (B9), IGGPMODI (DA), 
IGGPMVOL (BB), IGGPTXO (BI), IGGPRGBC (B9), 
IGGPRUS (B7), IGGPSALL (AR), IGGPUADD (B1), 
IGGPUDEL (B1), IGGPWRIT (BP) 


IGGPACDV (AB) 
IGGPMGO (AX), IGGPXVAL (BS) 


IGGPXDGO (BT) 


IGGPDOWN (BW), IGGPMBGO (AX), IGGPMVAR (AX) 


IGGPMGO (AX) 


IGGPDEL2 (AV), IGGPDOWN (BW), IGGPGREC (BA), 
IGGPRISE (BW), IGGPSFPL (AV), IGGPSNK2 (BW) 


IGGPXLT2 (BT) 

IGGPDEL2 (AV) 

IGGPDEL2 (AV) 

IGGPDOWN (BW), IGGPSINK (BW) 

IGGPAGOP (AW) 

IGGPDOWN (BW), IGGPRISE (BW), IGGPSINK (BW) 


IGGPACDV (AB), IGGPEXT (AZ), IGGPMOD (AV) 
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Procedure Called-By Directory (continued) 


Called module Calling procedure (in module): 
and its external (Abbreviated module name in 
procedures parentheses is IGGOCLxx) 
IGGOCLAZ 

Procedures: 


IGGPEXT IGGPALGV (BD), IGGPALIX (BE), IGGPALVA (BE), 
IGGPALVL (BE), IGGPALVR (BN), IGGPAUPG (B72), 
IGGPCGGC (B9), IGGPCKEX (BM), IGGPCLGT (BM), 
IGGPDALL (A5), IGGPDCDS (AF), IGGPDEFX (AQ), 
IGGPDELB (A5), IGGPDELC (AF), IGGPDELS (BL), 
IGGPDEMV (A7), IGGPDEVG (A7), IGGPDEXA (BG), 
IGGPDEXB (B5), IGGPDGDS (A4), IGGPDLCD (BL), 
IGGPDLVC (BL), IGGPDMSG (A7), IGGPDONE (AS), 
IGGPERUG (A4), IGGPEXGC (B9), IGGPFDSP (AD, 
IGGPGDSP (BJ), IGGPGGE (A2), IGGPGTAB (A2), 
IGGPINAE (B9), IGGPINIT (BC), IGGPLDCE (BK), 
IGGPLSTC (BQ), IGGPTXO (BI), IGGPRACE (DO), 
IGGPRUS (B7), IGGPSALL (AR), IGGPSALS (AU), 
IGGPSLCG (AA), IGGPSLEI (AM), IGGPSLEL (AM), 
IGGPSLER (AM), IGGPSLR (AA), IGGPSLY (AA), 
IGGPSRH2 (BP), IGGPSRH2 (BP), IGGPSVOL (BC), 
IGGPUADD (B1), IGGPUCOM (B1), IGGPUDEL (B11), 
IGGPUPDE (BB) 


IGGPLOC IGGPACDV (AB), IGGPFRWK (B7), IGGPRUS (B7) 
IGGOCLA2 

Procedures: 

IGGPGDGL IGGPSLOC (AM) 

IGGPGLOC IGGPSLOC (AM) 
IGGOCLA3 

Procedures: 

IGGPRE IGGPRACX (DC) 


IGGPRPLF IGGPCMRR (A9), IGGPCONV (BZ), IGGPDDBO (A9), 
IGGPDELC (AF), IGGPDYNA (A3), IGGPERAS (BG), 
IGGPGTSO (B6), IGGPPWGT (BM), IGGPRCU (C9) 


IGGPRPLM IGGPDYNA (A3), IGGPERAS (BG), IGGPGTSO (B6), 
IGGPPWGT (BM) 


IGGOCLA4 
Procedures: 
IGGPDEFB IGGPCDVR (AT) 
IGGPDEFX IGGPCDVR (AT) 
IGGPDGDS  IGGPDEFA (BH) 
IGGOCLAS5 
Procedures: 
IGGPDALL IGGPDELC (AF) 
IGGPDELB IGGPCDVR (AT) 
IGGPDELX IGGPCDVR (AT) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLA6 
Procedures: 
IGGPBJFB 
IGGPCBPT 
IGGPCRTC 
IGGPDALL 
IGGPDFS2 

IGGOCLA7 
Procedures: 
IGGPDEMV 
IGGPDF4T 
IGGPMCRA 
IGGPVMSC 

IGGOCLA8 
Procedure: 
IGGPDFRS 

IGGOCLA9 
Procedure: 
IGGPCCBC 

IGGOCLBA 
Procedures: 


IGGPGREC 


IGGPGVAL 


IGGPTSTS 
IGGOCLBB 
Procedure: 
IGGPUPDE 
IGGOCLBC 
Procedures: 
IGGPINIT 
IGGPSVOL 
IGGOCLBD 
Procedure: 


IGGPALT 
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Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPDEFS (AQ) 
IGGPDEFS (AQ) 
IGGPDEFS (AQ) 
IGGPDEL (BG) 

IGGPDEFS (AQ) 


IGGPDEL (BG) 

IGGPDLER (AF) 

IGGPDEL (BG) 

IGGPDCLS (B5), IGGPDEL (BG), IGGPDFBO (B8) 


IGGPDBDI (AJ) 


IGGPRPLM (A3) 


IGGPADGO (AW), IGGPAGOP (AW), IGGPDEL2 (AV), 


IGGPGREL (AW), IGGPGREP (AZ), IGGPMBGO (AX), 
IGGPMVAR (AX), IGGPSCNF (AZ), IGGPSFPL (AV), 
IGGPSGOP (AV), IGGPSNK2 (BW), IGGPXDGO (BT), 
IGGPXEL2 (BT), IGGPXEXS (BS), IGGPXVAL (BS) 


IGGPALT2 (AX), IGGPDEIN (BW), IGGPDOWN (BW), 
IGGPLOC2 (AZ), IGGPMVAR (AX), IGGPRISE (BW), 
IGGPUPGD (AZ), IGGPXDGO (BT), IGGPXEL2 (BT), 
IGGPXEXS (BS), IGGPXVAL (BS) 


IGGPSCNF (AZ), IGGPSFPL (AV) 


IGGPUPD (AV) 


IGGPSSWD (BB), IGGPUPDE (BB) 
IGGPSSWD (BB), IGGPUPDE (BB) 


IGGPCDVR (AT) 
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Procedure Called-By Directory (continued) 


Called module Calling procedure (in module): 
and its external (Abbreviated module name in 
procedures parentheses is IGGOCLxx) 
IGGOCLBE 

Procedures: 


IGGPALEC IGGPALVR (BN) 

IGGPALVL IGGPALT (BD) 

IGGPANVV  IGGPALT (BD) 
IGGOCLBF 

Procedures: 

IGGPSSCR IGGPBNUN (B8), IGGPRUS (B7), IGGPVMSC (A7) 
IGGOCLBG 

Procedures: 


IGGPDEL IGGPCDVR (AT), IGGPDELB (AS), IGGPDGDS (A4), 
IGGPDLET (BL) 


IGGPDEXA  IGGPDIAX (B5) 


IGGPDLXT IGGDBMD (B5), IGGPDCLS (B5), IGGPDEAX (BS), 
IGGPDEPT (B5), IGGPDEVG (A7), IGGPDEXB (BS), 
IGGPDF4T (A7), IGGPDIAX (B5), IGGPDIPT (B5), 
IGGPDUPG (B5), IGGPDUSC (A7) 


IGGPDOPN IGGPDCDS (AF), IGGPDIAX (B5}, IGGPFDSP (AI) 
IGGOCLBH 

Procedures: 

IGGPDAVO IGGPANVV (BE) 

IGGPDEFA IGGPCDVR (AT) 
IGGOCLBI 

Procedures: 


IGGPGET IGGPALEC (BE), IGGPALIX (BE), IGGPALNM (BD), 
IGGPALT (BD), IGGPALVE (BN), IGGPBCAN (B38), 
IGGPBSGT (BM), IGGPCDVR (AT), IGGPCKCC (B6), 
IGGPCLGT (BM), IGGPCNBO (B8), IGGPDALL (AS), 
IGGPDBDI (AJ), IGGPDCLS (B5), IGGPDDCE (BX), 
IGGPDEAX (B5), IGGPDEDE (AL), IGGPDEFS (AQ), 
IGGPDEFX (AO), IGGPDEL (BG), IGGPDELB (A5), 
IGGPDELC (AF), IGGPDELX (A5), IGGPDEPT (BS), 
IGGPDFBO (B8), IGGPDGDS (A4), IGGPDIAX (B5), 
IGGPDIPT (B5), IGGPDLET (BL), IGGPDOG (A3), 
IGGPDONE (A5), IGGPDSPO (AJ), IGGPDUND (B38), 
IGGPEXGC (B9), IGGPFDSP (AI), IGGPFRWK (B7), 
IGGPGETM (BR), IGGPGGE (A2), IGGPGLOC (A2), 
IGGPGRE (A3), IGGPGREC (BA), IGGPGUDS (BJ), 
IGGPINMD (B6), IGGPISCI (AG), IGGPLSP (BK), 
IGGPLSTC (BQ), IGGPMODC (B9), IGGPPRPW (B39), 
IGGPPWGT (BM), IGGPQNQC (AH), IGGPRUS (B7), 
IGGPSALL (AR), IGGPSLCG (AA), IGGPSLEI (AM), 
IGGPSLR (AA), IGGPSLY (AA), IGGPSMFA (BV), 
IGGPSMEL (BV), IGGPSMFM (BV), IGGPSPSC (B6), 
IGGPSSWD (BB), IGGPUADD (B1), IGGPUALL (BB), 
IGGPUCOM (B1), IGGPUDEL (B1), IGGPUEND (B1), 
IGGPUPDE (BB), IGGPUPGD (AZ), IGGPVMSC (A7), 
IGGPVRD (BN) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGPTNXO 
IGGPTXO 
IGGPUCRS 
IGGOCLBJ 
Procedure: 
IGGPGDSP 
IGGOCLBK 
Procedures: 
IGGPLDCS 
IGGPLSP 
IGGOCLBL 
Procedures: 
IGGPDELS 
IGGPDLET 
IGGPDLVM 
IGGPDUCB 
IGGOCLBM 
Procedure: 
IGGPBSGT 
IGGPCKAU 


IGGPCKEX 
IGGOCLBN 
Procedures: 
IGGPALMD 
IGGPALVR 
IGGPVRD 
IGGOCLBO 
Procedures: 
IGGPRAG 
IGGPRAPA 
IGGPRAPD 
IGGPRAPU 
IGGPRARC 
IGGPRASC 
IGGPXRIO 
IGGOCLBP 
Procedures: 
IGGPRET1 
IGGPSPAC 
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Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPDSPO (AJ), IGGPRUS (B7), IGGPUPDE (BB) 
IGGPDSPO (AJ), IGGPRUS (B7), IGGPUPDE (BB) 
IGGPSCAT (AH) 


IGGPACDV (AB) 


IGGPSMEFL (BV) 
IGGPACDV (AB), IGGPDEFS (AQ), IGGPDLMF (BL) 


IGGPCDVR (AT) 
IGGPFDSP (AI) 
IGGPFDSP (AI) 
IGGPFDSP (AI) 


IGGPRACV (DC) 


IGGPACDV (AB), IGGPCDVR (AT), IGGPDEFS (AQ), 
IGGPDOG (A3), IGGPLSTC (BQ), IGGPPRPW (B9) 


IGGPSPSC (B6) 


IGGPALT (BD) 
IGGPALVL (BE) 
IGGPALVL (BE) 


IGGPGET (BI) 

IGGPPAD (AG) 

IGGPPDE (AG) 

IGGPPAD (AG), IGGPPUPC (AG) 
IGGPRCU (C9) 

IGGPISCI (AG) 

IGGPWCRA (DA) 


IGGOCLC9 (C9) 
IGGPCSAL (BB) 


Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLBQ 
Procedure: 
IGGPLSTC 

IGGOCLBR 
Procedure: 


IGGPBMR 


IGGOCLBS 
Procedures: 
IGGPXEXT 
IGGPXVAL 

IGGOCLBT 
Procedures: 
IGGPXDGO 
IGGPXEL2 
IGGPXLT2 
IGGPXMOD 

IGGOCLBU 
Procedures: 


IGGPF4DQ 


IGGPF4RD 


IGGPF4WR 


IGGOCLBV 
Procedures: 


IGGPSMFA 


IGGPSMFL 
IGGPSMFR 
IGGPSMFS 


IGGPSMFZ 
IGGOCLBW 
Procedure: 


IGGPDEIN 


Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPCDVR (AT) 


IGGPMEBM (AE), IGGPEDS (AU), IGGPSALS (AU), 
IGGPSSCR (BF), IGGPXDGO (BT), IGGPXEL2 (BT), 
IGGPXVAL (BS) 


IGGPEXT (AZ) 
IGGPGVAL (BA) 


IGGPSFPL (AV) 
IGGPSFPL (AV) 
IGGPSFPL (AV) 
IGGPMOD (AV) 


IGGPDFM1 (AI), IGGPDF4T (A7), IGGPF4PR (AQ), 
IGGPRAPV (DA), IGGPRCTV (A7), IGGPSPAC (BP), 
IGGPVRCV (BN) 


IGGPCONV (BZ), IGGPDCBO (AE), IGGPDELC (AF), 
IGGPDFM! (AI), IGGPDF4T (A7), IGGPDLET (BL), 
IGGPFMT4 (B4), IGGPF4PR (AQ), IGGPRAPV (DA), 
IGGPRCTV (A7), IGGPSPAC (BP), IGGPVRCV (BN) 


IGGPCONV (BZ), IGGPDCBO (AE), IGGPDELC (AF), 
IGGPDF4T (A7), IGGPDLET (BL), IGGPFMT4 (B4), 
IGGPF4PR (AQ), IGGPRAPV (DA), IGGPRCTV (A7), 
IGGPSPAC (BP), IGGPVRCV (BN) 


IGGPALT (BD), IGGPDBDI (AJ), IGGPDCOC (ABE), 
IGGPDEFA (BH), IGGPDEFB (A4), IGGPDEFX (AQ), 
IGGPDOMF (AK), IGGPUPDE (BB), IGGPWSMF (B9) 


IGGPLSP (BK), IGGPUPDE (BB) 
IGGPALNM (BD) 


IGGPDCLS (BS), IGGPDEL (BG), IGGPDELB (AS), 
IGGPDEPT (BS), IGGDIPT (BS), IGGPDONE (AS) 


IGGPSMFG (B3) 


IGGPMVAR (AX) 


Directory 271 


Page of SY26-3826-3 
Revised July 28, 1978 
By TNL SN26-0912 


Procedure Called-By Directory (continued) 


Called module Calling procedure (in module): 
and its external (Abbreviated module name in 
procedures parentheses is IGGOCLxx) 
IGGOCLBX 

Procedures: 


IGGPDSPC IGGPDRDA (AN) 

IGGPPSPC IGGPDCCO (B0) 
IGGOCLBY 

Procedure: 

IGGPDRSP IGGPDRDA (AN) 
IGGOCLBZ 

Procedure: 

IGGPCONV IGGPCDVR (AT) 

IGGPGALO IGGPRFDC (DD) 
IGGOCLBO 

Procedure: 

IGGPDCCO  IGGPDSPC (BX) 

IGGPFPDA IGGPDDEP (AL) 

IGGPCMKY IGGPDRPG (AL) 

IGGPDCNV _ IGGPDPDI (AJ) 

IGGPDPBI IGGPDCCC (BX) 

IGGPITER IGGPDCCC (BX) 
IGGOCLB1 

Procedures: 

IGGPUADD IGGPAUPG (B2), IGGPDBDI (AJ), IGGPDUPG (B5) 

IGGPUDEL IGGPAUPG (B2), IGGPDUPG (B5) 


IGGOCLB2 
Procedure: 
IGGPAUPG  IGGPALT (BD) 
IGGOCLB3 
Procedures: 
IGGPSMF IGGPALT (BD), IGGPDEL2 (AV), IGGPPREC (AW), 
IGGPSNK2 (BW) 
IGGPSMFG = IGGPALT (BD), IGGPGREC (BA), IGGPSCNF (AZ), 
IGGPSFPL (AV) 
IGGOCLB4 
Procedure: 


IGGPDCRA IGGPDCSP (AS), IGGPDEFS (AQ) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLB5 
Procedures: 
IGGPDCLS 
IGGPDEAX 
IGGPDEPT 
IGGPDIAX 
IGGPDIPT 
IGGPDUPG 

IGGOCLB6 
Procedures: 
IGGPINMD 
IGGPSPSC 
IGGPWTSO 

IGGOCLB7 
Procedure: 
IGGPRUS 

IGGOCLB8 
Procedures: 
IGGPCNBO 
IGGPDFBO 
IGGPDUND 


IGGOCLC9 
Procedure: 
IGGOCLC9 

IGGOCLDA 
Procedures: 
IGGPMODI 
IGGPRAPV 
IGGPWCAT 
IGGPWCRA 

IGGOCLDC 
Procedures: 
IGGPRACG 
IGGPRACK 
IGGPRACS 
IGGPRACT 
IGGPRACV 


Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPDEL (BG) 
IGGPDEL (BG) 
IGGPDEL (BG) 
IGGPDEL (BG) 
IGGPDEL (BG) 
IGGPDEL (BG) 


IGGPCKAU (BM) 
IGGPCKAU (BM) 
IGGPPWGT (BM) 


IGGPUPD (AV) 


IGGPDSPO (AJ) 
IGGPDBDI (AJ) 


IGGPDCBO (AE), IGGPDCLS (B5), IGGPDEFA (BH), 
IGGPDFBO (B8), IGGPPAIX (B9) 


IGGOCLAI (A1) 


IGGPDCRA (B4) 
IGGPRAPA (BO), IGGPRAPD (BO), IGGPRAPU (BO) 
IGGPDCRA (B4) 
IGGPDCRA (B4) 


IGGPDGDS (A4) 

IGGPCLGT (BM) 
IGGPCKEX (BM) 
IGGPPWVR (BM) 
IGGPPWVR (BM) 
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Procedure Called-By Directory (continued) 


Called module 
and its external 
procedures 


IGGOCLDD 
Procedures: 
IGGPALRI 
IGGPALRN 
IGGPRDEF 
IGGPRDEL 
IGGPRDLC 
IGGPRFDC 
IGGPROBD 
IGGPRPTH 
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Calling procedure (in module): 
(Abbreviated module name in 
parentheses is IGGOCLxx) 


IGGPCDVR (AT) 

IGGPALNM (BD) 

IGGPDEDE (AL), IGGPCDVR (AT) 
IGGPCDVR (AT) 

IGGPCDVR (AT) 

IGGPCDVR (AT) 

IGGPDCLS (BS) 

IGGPDIPT (BS) 


DATA AREAS 


C 


“Data Areas” describes the OS/VS2 catalog and its records. ‘“Data Areas” 
also describes each OS/VS2 catalog management control block, and shows 
the relationships between the catalog managment control blocks. 


Catalog Record Descriptions 


: Each 512-byte catalog record in the low-key range of the catalog occupies a 
full control interval and contains the number of the control interval in which it 
resides. Each catalog record also contains the record type of the record. The 

: low-address part of the catalog is made up of the following types of records: 


Alias name record, which relates an alias name to the nonVSAM data set’s 
or user catalog’s True Name record. This record is record type ‘“‘X.” 


Control record, which describes the free control intervals in the 
low-address part of the catalog. The Control record is the fourth record in 
the catalog. This record is record type “‘L.”’ 


Free record, which marks the control interval in which it resides as 
available for use as another kind of catalog record. There is one Free 
record for each previously assigned control interval that is available for 
use. This record is record type “‘F.”’ 


Cluster record, which describes a VSAM data-set cluster or a pagespace 
(conceptually an entry-sequenced VSAM data set). This record contains 
the control interval number of a Data record and, if the VSAM data set is a 
key-sequenced data set, the control interval number of an Index record. 
There is one Cluster record for each VSAM cluster cataloged. This record 
is record type “‘C.” 


Data and Index records, which describe data sets and indexes. A Data 
record can also describe a pagespace (conceptually an entry-sequenced 
VSAM data set). There is one Data or Index record for each data set or 
index cataloged. These records are record types ““D” and “I.” 


Alternate index record, which relates the alternate index to its associated 
base cluster and also to any paths over it. This record is record type “G.”’ 


Path record, which relates a base cluster and possibly an alternate index. 
This record is record type “‘R.” 


Upgrade set record, which relates the data and index components of the 
alternate indexes that comprise the upgrade set. This record is record type 
abs Gai 


Generation data group (GDG) base record, which contains the control 
interval number and generation level (absolute name) of each generation 
data set in the group. This record is record type “‘B.”’ 


NonVSAM record, which describes a data set organized differently from 
VSAM. There is one NonVSAM record for each nonVSAM data set 
cataloged. This record is record type “‘A.”’ 


User-Catalog record, which describes a user catalog. There is one 
User-Catalog record for each user catalog connected to the master catalog. 
This record is record type “‘U.”’ 
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¢ Volume record, which describes each VSAM data space on a volume, the 
data sets that reside in the data space, and the space available within the 
data space. There is one Volume record for each volume controlled by this 
catalog. This record is record type ‘“‘V.” 


e Extension record, which contains overflow information from another 
catalog record. There are as many Extension records as are required to 
contain overflow information. This record is record type ‘““W”’ when it is an 
extension of a Volume record; it is record type ““E”’ when it is an extension 
of any other catalog record. 


The Cluster, Data, Index, Alternate Index, Path, Upgrade Set, NonVSAM, 
Extension, Alias, GDG Base, and User-Catalog records have a common 
general format. Figure 39 shows the general format for these records. 


Header fields 
0(0) 1(1) 4(4) 5(S) 11(B) 14(E) 18(12) 22(16) 26(1A) 27(1B) 


amare RELIND CRAVOL CRAIDNO CRADEVT | CRACRETS| CRADITS SECFLAGS 


Security flags 
for cluster, data, 
alternate index, 
and path records; 
zeros for other 
record types. 


Identifies the release: 
Q = Nonenhanced 
VSAM 
Enhanced 

VSAM 


For recoverable 
catalogs, identifies 
the CRA volume 


For recoverable 
catalogs, the 
data or index 
creation time- 
stamp. Zeros 
for other record 
types 


serial number. 


For recoverable 
catalogs, the CRA 
creation time-stamp. 


For recoverable 
catalogs, indicates 
the CRA control 
interval number. 


For recoverable catalogs, 
the CRA device type (same 
as UCB device type field, 
except (1) shared bit is 
turned off, (2) RPS bit is 
turned off (3340 only), 
and (3) power warning 

bit is turned off. 


Figure 39 (Part 1 of 2). Catalog Record—General Format 
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$>—— Header fields a ea 
44(2C) 45(2D) 47(2F) 48(30) 49(31) 93(5D) (*1) 
Record L_ | True DSNAME Fixed-length Variabletength 
size fields fields 


>—— key ——> 


Identifies the type Count of Length (in bytes) 
of catalog record: variable- to the end of the 
NonVSAM length fixed-length 
GDG Base fields fields 


Cluster 
(usually 


Data 
Free zero) *1 


Alternate Index 
CCR 

Index 
Extension 


Path 
User-catalog Since there are usually no variable- 


Alias length fields, ‘‘L”’ points to the 
Upgrade set horizontal-extension-record pointer *1 
Volume 

Extension for a 

volume record 


Sct KCAMraAmtIOw>D 


5 bytes 1 byte 5 bytes S byte pointers (* 2) Variable-length sets of fields 


Number of 
sets of 
fields 


tHorizontal 
extension 


ASPT (Available- 
space pointer) 


(1)(*2) 


Set-of-fields pointers Sets of fields 


The set of Number of 
fields is Revered bytes from Sequence Fixed-length | Variable-length 
in this the first number fields fields 


record set of fields 


*] The GDG Base 
catalog record’s 


header fields include | The set of 
a variable-length fields is Control 


field. in an interval 


*2 The volume catalog | °Xtension number 
record and its record 
extension (types V 
and W) have 6-byte 
set-of-fields pointers, 
because of 2-byte 
sequence numbers. 


Number of Length of the 
variable- fixed-length fields— 
length this includes the “C”’ 
fields and “‘L”’ bytes. 


Sequence 
number 


0: Set of fields in record 
1: Set of fields in extension Each variable-length field: 


1: Inactive set-of-fields pointer (2) 


Figure 39 (Part 2 of 2). Catalog Record—General Format 
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Sets of Fields in the Catalog Records 


Related fields of information are grouped into sets of fields so they can be 
treated as a unit. For example, all fields relating to one volume on which a 
data set resides are grouped together. If a data set resides on three volumes, 
there are three sets of volume information. All pointers to volume information 
sets of fields are contiguous, however. These sets of volume information fields 
are not necessarily contiguous. Each pointer to a set of fields contains a code 
that identifies the kind of information it contains so that the sets of fields that 
contain volume information can be distinguished from other sets of fields. 
Note that it is possible for one record to contain many sets of fields. 


J 


Following are the sets of fields that can occur in Cluster, Alternate Index, 
Path, Upgrade, Data, Index, Alias, GDG Base, NonVSAM, and User-Catalog 
records: : 


¢ AMDSB (Access Method Data Statistics Block), which appears in Data 
and Index records. Only one copy of an AMDSB appears in a record. A 
pointer to AMDSB information contains a code of 1. 


¢« Association information, which appears in Data, Index, Cluster, Alternate 
Index, Path, Upgrade, User Catalog, NonVSAM, Alias, and GDG Base 
catalog records. Figure 40 illustrates the associations that can occur in 
these records. Each arrow represents an association. Associations shown 
by a broken line exist only when the base cluster is a key-sequenced data 
set. A cluster might not have any alternate indexes, paths, upgrade sets, or 
alias paths; a cluster’s alternate index might not be part of the cluster’s 
upgrade set. Note that multiple alternate indexes, paths, nonVSAMs, 
aliases, and alias paths may exist. 


¢ Volume information, which appears in Data, Index, User Catalog and | 
NonVSAM records. This set of fields describes all of the direct-access J 
device space allocated to the data set (or index, etc.) on a particular 
volume. A separate set of volume information fields is used to describe the 
space on each volume. If the data set’s space on a volume is divided into 
key ranges, each key range is described in a separate set of volume 
information fields. As many sets of volume information fields as are 
required to describe allocated space can appear. A pointer to volume 
information contains a code of 3. 


¢« Password information, which can appear in Data, Index, Alternate Index, 
Path, and Cluster records. This set of fields contains the security 
information for a data set (or index, etc.). Only one set of password 
information fields can appear. A pointer to password information contains 
a code of 4. 


The Volume record can also contain sets of fields, as follows: 


¢ Track allocation information (Space Map set of fields). This set of fields 
describes each track on the volume as allocated to a VSAM object or 
unallocated. Each volume record contains as many of these sets of fields as 
are required to describe the entire volume. A pointer to track allocation 
information contains a code of 5. 


« VSAM data space information (Data Space Group set of fields). This set 
of fields describes a VSAM data space on the volume. One set of fields is 
required to describe each data space and its extents on the volume. A 
pointer to data space information contains a code of 6. 
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“R” 


Alias Path oo 


“—G” 
Alternate Index 


a Gigs 
Base Cluster 


“Dp” 
Alternate Index 
Data 


Base Index 


sl Ba 
Base Data 


“uy ” 
Upgrade 


su ?? or “A” 
User catalog 
or NonVSAM 


“A” 
NonVSAM 


oy ay 
NonVSAM 


“RB” 
Generation 
Data Group 


( Figure 40. Catalog Record Associations 
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¢ Data set information (Data Set Directory Entry set of fields). This set of 
fields describes a data set that resides in a VSAM data space. One set of 
fields is required for each data set. A pointer to data set information 
contains a code of 8. 


Note: If a Cluster, Alternate Index, Upgrade, Data, Index, NonVSAM, User 
Catalog, GDG Base, or Volume record is extended, these sets of fields 
(except for the AMDSB set of fields) are moved, as required, into an 
Extension record. 


Locating Fields in Catalog Records 


A field name dictionary, which is part of the catalog management code, allows 
catalog management to locate fields within catalog records by name. The 
dictionary also allows for combination field names—each combination field 
name allows catalog management to locate a group of related fields. 


Catalog records and the field-name dictionary are described in the topics that 
follow. 


Catalog Recovery Area Record Descriptions 


Catalogs that are defined with the recoverable attribute are associated with 
one or more CRAs (catalog recovery areas). A CRA is a VSAM 
entry-sequenced data set, and every volume owned by a recoverable catalog 
contains one CRA. 


Each CRA contains three types of 512-byte records: 
« Self-describing records 

e Duplicate copies of VSAM catalog entry records 
e CRA free records 


Self-describing records and free records occupy control intervals 0-8 in the 
CRA. The control intervals and the specific record they contain are: 


Record 
CI Number Type Description 

0 D Data set record, which describes the CRA data 
component of the CRA cluster 

1 F Free record 

2 Cc Cluster record, which describes the CRA cluster 

3 L Control record, which manages control interval 
allocation in the CRA 

4 F Free record 

5 E _ Extension record, which is an extension of the 
data set record in control interval 0 

6,7,8 F Free records 


The formats and contents of the self-describing records are shown later in the 
*‘Data Areas” section. 


Duplicate copies of catalog records are recorded in the CRA in control 
intervals 9-n. The volume record for the CRA volume is in control interval 9. 
The format and content of these duplicated records are identical to their 
counterparts in the recoverable catalog associated with the CRA. 
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Each catalog record that is not self-describing is duplicated in a specific CRA. 
The table that follows shows which CRA contains a given catalog record. In 
the table, initial volume is the first volume on which space was allocated for 
the entity. 


Record 
Catalog Entry Type CRA 
Volume records V,W Subject volume 
KSDS cluster records C,E Initial prime index volume 
KSDS data records D,E Initial prime index volume 
KSDS index records LE Initial prime index volume 
AIX cluster record (KSDS) G,E Initial prime index volume 
of the base cluster 
AIX data record (KSDS) D,E Initial prime index volume 
of the base cluster 
AIX index record (KSDS) ILE Initial prime index volume 
of the base cluster 
AIX cluster records (ESDS) G,E Initial base data volume 
AIX data records (ESDS) D,E Initial base data volume 
AIX index records (ESDS) LE Initial base data volume 
Path records (KSDS, no AIX) R,E Initial prime index volume 
Path records (ESDS, no AIX) R,E Initial base data volume 
Path records (KSDS, AIX) R,E Initial prime index volume 
of the base cluster 
Path records (ESDS, AIX) R,E Initial base data volume 
Upgrade records (KSDS) Y,E Initial prime index volume 
of the base cluster 
Upgrade records (ESDS) ¥,E Initial base data volume 
NonVSAM, Generation Data A,B,E,U,X Catalog volume 


Group, User catalog, and 
Alias records 
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True-Name Catalog Record Format 


The True Name catalog record associates the volume serial number, data set 

DSNAME, alternate (alias) DSNAME of a nonVSAM data set or user J 
catalog, user catalog DSNAME, or cluster, alternate index, or path DSINAME 

specified by the user with the control interval number of the catalog record 

that describes the object (volume, data set, alias, user catalog, alternate index, 

path, or cluster). True Name records are contained in the high-address part of 

the catalog and are pointed to by the catalog’s index records. The True Name 

record is retrieved using key-sequenced processing. The catalog management 

modules convert the control interval number in the True Name record to an 

RBA for entry-sequenced processing. 


True Name records are 47 bytes long; several might be contained in a 
catalog’s (512-byte) control interval. 


Bytes and 

Offset Bit Pattern Description 

0 (0) 44 DSNAME of a data set, cluster, user catalog, 
nonVSAM data set, alternate index, path, or 
alternate DSNAME (alias), filled on the right 
with blanks, or a volume serial number, filled 
on the right with zeros, specified by the user. 

44 (2C) 3 Control interval number of the catalog 


record that describes the object. 


Catalog Control Record (CCR) Format 


The catalog control record (CCR) is used by catalog management to control 

the allocation of control intervals in the low-address part of the catalog, | 
where catalog records, excluding the True Name records and the index, J 
reside. The CCR also shows the catalog’s high-used and high-allocated RBA 

values. The catalog control record is the fourth record (control interval) in the 

catalog. 


For a request of one catalog record, catalog management tries to use a record 
that was freed because of deletion. This process is done before using 
unassigned space. If more than one catalog record is needed, catalog 
management tries to use contiguous unassigned space in the current extent; if 
sufficient unassigned space is not available, records that have been deleted are 


used. 
Bytes and 
Offset Bit Pattern Description 
0 (0) 44 Key. 
Byte Meaning 
0 Zeros. 
1-3 Control! interval number of this record. 
4 Release indicator. 
5-43 Zeros. 
44 (2C) 1 Record type—‘L.”’ 
45 (2D) 3 Number of the highest control interval within the current 
extent.! 
48 (30) 3 Number of the next free control interval of those that have 
not been previously assigned. ! 
51 (33) 3 Count of deleted control intervals, that is, the count of . 
control intervals that are free because of deletion.? ) 
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Catalog Control Record Format (continued) 
« Bytes and 
Offset Bit Pattern 


54 (36) 3 First deleted control interval in a chain of control intervals 
that are free because of deletion.2 


Description 


The following fields are used to keep track of the RBA values that denote the current logical 
end (high RBA) of parts of the catalog: 


57 (39) 4 Data, low key range: high-key RBA 
61 (3D) 4 Data, low key range: high-used RBA 
65 (41) 4 Data, low key range: high-allocated RBA 
69 (45) 4 Data, high key range: high-key RBA 
: 73 (49) 4 Data, high key range: high-used RBA 
77 (4D) 4 Data, high key range: high-allocated RBA 
81 (51) 4 Index, high level: high-used RBA 
85 (55) 4 Index, high level: high-allocated RBA 
89 (59) 4 Index, low key range—sequence set: high-used RBA 
93 (SD) 4 Index, low key range—sequence set: high-allocated RBA 
97 (61) 4 Index, high key range—sequence set: high-used RBA 
. 101 (65) 4 Index, high key range—sequence set: high-allocated RBA 


1 This field is used to keep track of unassigned space within the current extent. 
This field is used to keep track of previously-used records that are now available for use as other catalog 
records. 


C Free Catalog Record Format 


The Free catalog record indicates that the control interval in which it resides 
is free and points to the next control interval that is free because of deletion. 
Note that the Free catalog record is used only to mark a record that was used 
and has been deleted. The free space (control intervals) in the catalog that 
has never been assigned is not represented by Free catalog records. 


Bytes and 

Offset Bit Pattern Description 

0 (0) 44 Key. 
Byte Meaning 
0 Zeros. 
1-3 Control interval number of this record. 
4-43 Zeros. 

44 (2C) | Record type—‘‘F.”’ 

45 (2D) 3 Control interval number of the next free control interval. 
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Data and Index Catalog Record Format 


Data and Index records describe data sets and their indexes. A Data record 
can also describe a pagespace, which is similar to an entry-sequenced VSAM 
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data set. 

Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 1 Zeros. 

1 (1) 3 ENTIDNO Control interval number of this record. 

4 (4) 1 RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 

5 (5) 6 CRAVOL CRA volume serial. ! 

11 (B) 3 CRAIDNO CRA control interval number.! 

14 (E) 4 CRADEVT CRA device type. ! 

18 (12) 4 CRACRETS CRA creation time stamp. 

22 (16) 4 CRADITS Time stamp. Data/index identifier. 

26 (1A) ] SECFLAGS Security attributes. 

bes Indicates record is RACF-protected. 
.XXX XXXX Reserved. 
+ 27 (1B) 17 Zeros. 

44 (2C) 1 ENTYPE Record type—‘‘D” for a Data record or “I” 
for an Index record. 

45 (2D) Z Record length. 

47 (2F) 1 Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero for a Data and Index catalog record. 

48 (30) 1 Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 143 (X‘8F’). This 
value is always equal to the displacement 
from the beginning of the record to the 
pointer to an Extension record. 

49 (31) 44 ENTNAME For a Data or Index catalog record, the data 
sets DSNAME. 

93 (SD) 8 OWNERID Owner of the data set, specified when the 
data set was defined. 

101 (65) 3 DSETCRDT Data set creation date, in packed-decimal 
form YDD, specified when the data set was 
defined. 

104 (68) 3 DSETEXDT Data set expiration date, in packed-decimal 


form YDD, specified when the data set was 
defined. 
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Data and Index Catalog Record Format (continued) 


Offset 
107 (6B) 


108 (6C) 


109 (6D) 


110 (6E) 
114 (72) 


117 (75) 


Bytes and 
Bit Pattern Field Name 
1 ATTRI 
l... 
ro ae 
Ba ie 
re 
1... 
Jl 
seal 
saute 1 
1 ATTR2 
00.. .... 
Oles: 22a: 
LOvss 2st 
11... .... 
..00 .... 
Ol .... 
me | 0 eres 
7 eee 
zl 
| 
XX.. 
1 OPENIND 
4 BUFSIZE 
3 PRIMSPAC 
3 SCONSPAC 


Description 


Data set attributes, which are defined in 
Access Method Services commands, as 
follows: 


Speed, which indicates that direct-access 
device storage for the data set or index is not 
to be preformatted before records are 
written. 

Unique, which indicates that this data set or 
index must reside in a data space all its own. 
The cluster associated with this component is 
reusable. 

Erase, which indicates that the data set or 
index is to be overwritten with binary zeros 
when deleted. 

This catalog is recoverable. 

Inhibit update, which indicates that the data 
set or index is not to be updated. 

Temporary export, which indicates that the 
original copy of this data set or index is not 
to be deleted, even though another copy of it 
exists somewhere else. 

Track overflow—can be set on only in a Data 
catalog record that describes a pagespace. 


Data set sharing attributes as follows: 


The data set can be shared by READ users or 
it can be used by one UPDATE/OUTPUT 
user. 

The data set can be shared by READ users 
and one UPDATE/OUTPUT user. 

The data set can be fully shared. 

The data set can be fully shared, with 
assistance supplied by VSAM. 


Data set sharing attributes across systems, as 
follows: 


Reserved. 

Reserved. 

The data set can be fully shared. 

The data set can be fully shared, with 
assistance supplied by VSAM. 


Internal system data set 
Component is not usable. 
Reserved. 


Open indicator flag; if this byte contains 
X‘80’, the data set is open for output. 


Minimum buffer size. 


Primary space allocation for the data set or 
index, specified when the data set or index 
was defined. 


Secondary space allocation for the data set or 
index, specified when the data set or index 
was defined. 
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Data and Index Catalog Record Format (continued) 


Field Name 
SPACOPTN 


HURBADS 
HARBADS 
LRECL 


USERINFO 


EXCPEXIT 


Description 
Space options flags. 


Track request, which indicates that space 
allocation was specified in tracks. 

Cylinder request, which indicates that space 
allocation was specified in cylinders. 
Reserved. 


High-used RBA of the data set or index. 
High-allocated RBA of the data set or index. 


For a Data catalog record, the logical record 
size of the data set; for an Index catalog 
record, always X ‘FF’s. 


User information for the DOS/VS 
indexed-sequential access method 
compatibility interface. 


Exception exit. 


The following six-byte entry contains control information for the sets of fields that follow it. 


Bytes and 
Offset Bit Pattern 
120 (78) 1 
108: sunes 
|) Pee 
XX XXXX 
121 (79) 4 
125 (7D) 4 
129 (81) 4 
133 (85) 2 
135 (87) 8 
143 (8F) 5 
148 (94) 1 
149 (95) VL 
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Pointer to the horizontal Extension record. If 
this record is not continued in an Extension 
record, this field contains zeros. 


The number of set-of-fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 


0 to 2 are zero, the pointer is a dummy 


set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record. 


Byte Meaning 


0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 1 ts 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a type (group) code of 2 are in 
one sequence. 


Data and Index Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 
VL 5-byte pointers to sets of fields contained in 

vertical Extension records. 

Byte Meaning 

0-2 Control interval number of the 
Extension record that contains this 
set of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a type (group) 
code that describes the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a type (group) code of 2 are in 
one sequence. 

1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 
2 Fields describing (a) the AMDSB, (b) the control interval number of a Cluster record associated with this 
record, (c) the volumes on which a data set or index resides, and (d) the password information associated 


with a data set are grouped into sets of fields. Pointers to each set of fields identify the type of information 
contained in each set of fields. 


AMDSB (Access Method Data Statistics Block) Set of Fields 
Format 
The AMDSSB set of fields contains a copy of the AMDSB control block, and 


is updated each time the data set is closed. This set of fields is associated with 
a pointer that contains a type (group) code of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields. 
1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


2 (2) 96 AMDSBCAT Copy of the AMDSB—Access Method Data 
Statistics Block. See ““Data Areas” for 
detailed information about the AMDSB. 
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Association (Cluster) Set of Fields Format 


The control interval number of the cluster catalog record associated with the 
data set or index catalog record is contained in the association set of fields. 


This set of fields is associated with a pointer that contains a type (group) code 


of 2. 


Offset 
0 (0) 


2 (2) 


3 (3) 


Bytes and 
Bit Pattern 


Z 


1 


3 


Volume Information Set of Fields Format 


Field Name 


TYPE 


NAME 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


““C,”’ which indicates that this record is 
associated with a Cluster record, or “‘G,”’ 
which indicates this is the data component or 
the index component of an alternate index. 
The data component of a cluster may have 
an additional ““Y’’ association if the cluster 
has an alternate index that is part of the 
upgrade set. 


Control interval number of the Cluster or 
Alternate Index record associated with this 
record. 


All extents allocated to the data set, index, or data set’s key range on a 
volume are described by a volume information set of fields. This set of fields 
is associated with a pointer that contains a type (group) code of 3. 


Offset 
0 (0) 


2 (2) 
6 (6) 
12 (C) 
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Byte and 
Bit Pattern 


2 


Field Name 


DEVTYP 
VOLSER 
FILESEQ 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Device type. 
Volume serial number. 


File sequence number. (This field is provided 
for compatibility with the OS/VS catalog, 
and is used for nonVSAM data sets that 
reside on tape volumes. ) 


J 


Data Set and Index Catalog Record: Volume Information Set of Fields Format 


(continued) 
Bytes and 
Offset Bit Pattern Field Name 
14 (E) 1 VOLFLG 
lus 
Pa be 
i. 
wX XXXX 
15 (F) 1 NOEXTNT 
16 (10) 4 HKRBA 
20 (14) 4 HURBA 
24 (18) 4 HARBA 
28 (1C) 4 PHYBLKSZ 
32 (20) 2 NOBLKTRK 
34 (22) 2 NOTRKAU 
36 (24) 1 ITYPEXT 
1... 
.eXX XXXX 
37 (25) 2 DSDIRSN 
39 (27) 4 NOBYTTRK 
43 (2B) 4 NOBYTAU 


Description 


Volume flags, as follows: 


Prime, which indicates that this volume was 
allocated when the data set was defined or 
that a data set that is not divided into parts 
according to key (a key-range data set) has 
been extended to this volume. 

Candidate, which indicates that this volume 
is available for use by the data set described 
by this record. 

Overflow, which indicates that this volume is 
being used by a data set that is divided into 
parts according to key (a key-range data set), 
but this volume was not allocated when the 
data set was defined. 

Reserved 


Number of extents allocated in this set of 
extents on this volume for this data set. 


RBA of the data control interval with the 
high key. 


High used RBA. 

High allocated RBA. 

Block size. 

Number of blocks per track. 
Number of tracks per allocation unit. 
Flags: 


In an index record: the sequence set is with 
the data. 

The extents are not preformatted 
Reserved 


Data set directory sequence number in the 
volume record. 


Number of bytes per track—nonexistent 
unless the record describes a pagespace. 


Number of bytes per allocation 
unit—nonexistent unless the record describes 
a pagespace. 
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Data Set and Index Catalog Record: Volume Information Set of Fields Format 


(continued) 
Bytes and 
Offset Bit Pattern 
47 (2F)! VL 
VL 
VL 


Field Name 
LOKEYV 


HIKEYV 


EXTENT 


Description 


Low key on the volume. This field can be a 
maximum of 64 bytes long; the first two bytes 
(control information) indicate the length of 
the field. 


High key on the volume. This field can be a 
maximum of 64 bytes long; the first two bytes 
(control information) indicate the length of 
the field. 


This field contains a 2-byte length field 
(control information), followed by a 20-byte 
field for each extent. The 20-byte field 
describes the start and end of the extent, in 
the form SSCCHHCCHHTTDDDDDDDD, 
where SS is the data space extent’s sequence 
number, CCHHCCHH is the low and high 
cylinder and head, TT is the number of 
tracks, and DDDDDDDD is the low and 
high RBA of the extent. 


1 The offset to LOKEYV is 39 (27) when the record doesn’t describe a pagespace (and NOBYTTRK and 
NOBYTALU are nonexistent). The second byte of the record contains the displacement. 


Password Set of Fields Format 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 


Offset 
0 (0) 


2 (2) 


36 (24) 


42 (2A) 


44 (2C) 


52 (34) 
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Bytes and 
Bit Pattern 


pe 


32 


VL 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 

Control information. 

Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set’s DSNAME. 


Maximum number of attempts allowed for 
the operator or TSO operator to provide the 
correct password. 


Name of user’s security-verification module, 
if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 


Cluster Catalog Record Format 
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The Cluster catalog record points to its data set’s Data catalog record. If the 
data set is key-sequenced, the Cluster catalog record also points to the data 
set’s Index catalog record. The Cluster catalog record can point to a Data 
catalog record that describes a pagespace (conceptually an entry-sequenced 
VSAM data set). In addition, the cluster may point to one or more alternate 


indexes or one or more alias paths. 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
26 (1A) 


27 (1B) 


44 (2C) 


45 (2D) 


47 (2F) 


48 (30) 


49 (31) 


93 (5D) 


101 (65) 


104 (68) 


107 (6B) 


Bytes and 
Bit Pattern 


1 


XXX XXXX 


17 


1 
2 
1 


1 


44 


8 


3 


3 


1 


XXXX XX.. 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


SECFLAGS 


ENTYPE 


ENTNAME 


OWNERID 


DSETCRDT 


DSETEXDT 


CATTR 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number.! 
CRA device type.! 

CRA creation time stamp. 

Zeros. 

Security attributes. 

Indicates record is RACF-protected. 
Reserved 

Zeros 


> 


Record type—‘‘C. 
Record length. 


Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero for a Cluster catalog record. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields that 
follow displacement 108 (X‘6C’). This value 
is always equal to the displacement from the 
beginning of the record to the pointer to an 
Extension record. 


DSNAME of the cluster described by this 
record. 


Owner of the cluster, specified when the 
cluster was defined. 


Cluster creation date, in packed-decimal 
form YDD, specified when the cluster was 
defined. 


Cluster expiration date, in packed-decimal 
form YDD, specified when the cluster was 
defined. 


Cluster attributes: 
The cluster describes a swapspace 


The cluster describes a pagespace 
Reserved 
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Cluster Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 


The following 6-byte entry contains control information for the sets of fields that follow it. 


108 (6C) 5 Pointer to the horizontal Extension record. If 
this record is not continued on an Extension 
record, this field contains zeros. 


113 (71) 1 The number of set-of-fields pointers that 
follow.2 


Note: The first set-of-fields pointer might be 
special (meaning that the field-name 
dictionary permits catalog management to 
locate information that is not contained in 
catalog records); if so, its sequence number = 
0 and type code = 0. When bytes 0 to 2 are 
nonzero, this set-of-fields pointer points to 
the first (vertical) extension record that 
contains free space. The set-of-fields pointer 
is called the ASPT—available-space pointer. 
When bytes 0 to 2 are zero, the pointer is a 
dummy set-of-fields pointer—not available to 
be used to point to a set of fields. 


114 (72) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to by code. For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 


VL 5-byte pointers to sets of fields contained in 
vertical Extension records. 
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Cluster Catalog Record Format (continued) 


Offset 


Bytes and 
Bit Pattern 


Field Name 


Description 
Byte Meaning 
0-2 Control interval number of the 


Extension record that contains this 
set of fields. 


Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a type (group) 
code that describes set of fields 
pointed to. 


Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a code of 2 are in one sequence. 


1 Zeros if the catalog is not recoverable or if there is no associated CRA entry. 
Fields describing (a) the control interval number of a Data or Index catalog record associated with this 
cluster, or (b) the password information associated with a data set are grouped into sets of fields. Pointers to 
each set of fields identify the type of information contained in each set of fields. 


Association (Data and Index) Set of Fields Format 


The control interval number of the Data and Index catalog record associated 
with the cluster is contained in an association set of fields. This set of fields is 
associated with a pointer that contains a type (group) code of 2. 


Offset 
0 (0) 


2 (2) 


3 (3) 


Bytes and 
Bit Pattern 


2 


1 


3 


Field Name 


TYPE 


NAME 


Description 


Control information. 


Byte 
0 


Meaning 


Count of the number of 
variable-length fields in this set of 
fields. 

Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 


If this entry describes an Index catalog 
record, “‘I;” if this entry describes a Data 
catalog record, ‘‘D;”’ if this entry describes 


9 
° 


an alternate index entry, “‘G;”’ if this entry 


describes an alias path entry, “R 


9 
e 


Control interval number of a Data, Index, 
Alternate Index, or Alias Path catalog record 
that describes part of the cluster described by 
this record. 


Data Areas 293 


Page of SY26-3826-3 
Revised July 28, 1978 


By TNL SN26-0912 
Password Set of Fields Format 
Password information, if any, is contained in the password set of fields. This P 
set of fields is associated with a pointer that contains a type (group) code | 
of 4. 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 
1 Hexadecimal displacement to the 
first variable-length field from the : 
beginning of this set of fields. 


2 (2) 32 PASSWORD Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


34 (22) 8 PASSPRMT Password prompting code name that allows 
the operator to provide the correct password 
without displaying the clusters DSNAME. 


42 (2A) 2 PASSATMP Maximum number of attempts allowed for 
the operator or TSO operator to provide the 
correct password. 


44 (2C) 8 USVRMDUL Name of the user’s security-verification 
module, if any. 
52 (34) VL USERAREC User-authorization record. This field can be a 


maximum of 256 bytes long. J 
Alternate Index Catalog Record Format 


The alternate index record describes the data and index components 
associated with the alternate index. In addition, it points to the related cluster 
entry and it can point to one or more path entries. The alternate index 
grouping is similar to the grouping of a key-sequenced data set except for 
different record types (‘‘G” rather than “‘C’’). 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) l Zeros. 
1 (1) 3 ENTIDNO Control interval number of this record. 
4 (4) 1 RELIND Release indicator: ; 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 
5 (5) 6 CRAVOL CRA volume serial. : 
11 (B) 3 CRAIDNO CRA control interval number. 
14 (E) 4 CRADEVT CRA device type. 
18 (12) 4 CRACRETS CRA creation time stamp. 
22 (16) 4 Zeros. 
26 (1A) | SECFLAGS Security attributes. 
| eearceree Indicates record is RACF-protected. 
.XXX XXXX Reserved J 
27 (1B) 17 Zeros. 
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Alternate Index Catalog Record Format (continued) 


Offset 

44 (2C) 
45 (2D) 
47 (2F) 
48 (30) 


49 (31) 


93 (SD) 


101 (65) 


104 (68) 


107 (6B) 


Bytes and 
Bit Pattern 


1 
2 
1 


oXXX XXXX 


Field Name 
ENTYPE 


ENTNAME 


OWNERID 


DSETCRDT 


DSETEXDT 


RGATTR 


Description 


99 


Record type—‘‘G. 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record (always 
zero). 


Length of nonrepeating fixed-length fields 
(always X‘6C’). 


Name of the alternate index described by this 
record. 


Owner of the alternate index described by 
this record; specified when the alternate 
index was defined. 


Alternate index creation date, in the 
packed-decimal form YDD. 


Alternate index expiration date, in the 
packed-decimal form YDD. 


Alternate index attributes: 


If there is an association in the upgrade 
entry, indicates that this alternate index is a 
member of the upgrade set. 

Reserved. 


The following 6-byte entry contains control information for the sets of fields that follow it. 


108 (6C) 


113 (71) 


5 


1 


Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


The number of-set-of fields pointers that 
follow. ! 


Note: The first set-of-fields pointer might be 
special (meaning that the field-name 
dictionary permits catalog management to 
locate information that is not contained in 
catalog records); if so its sequence number = 
0 and type code = 0. When bytes 0 to 2 are 
nonzero, this set-of-fields pointer points to 
the first (vertical) extension record that 
contains free space. The set-of-fields pointer 
is called the ASPT—available-space pointer. 
When bytes 0 to 2 are zero, the pointer is a 
dummy set-of-fields pointer—not available to 
be used to point to a set of fields. 
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Alternate Index Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 


114 (72) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and | are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to by code. For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 


VL 5-byte pointers to sets of fields contained in 
vertical extension records. 


Byte Meaning 


0-2 Control interval number of the 
extension record that contains this 
set of fields. 

3 Bits O and 1 are set to B‘10.. Bits 2 


through 7 contain a type (group) 
code that describes set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a code of 2 are in one sequence. 


1 Fields describing (a) the control interval number of a Data or Index catalog record associated with this 
cluster, or (b) the password information associated with a data set are grouped into sets of fields. Pointers to 
each set of fields identify the type of information contained in each set of fields. 


Association Set of Fields Format 


The associations in this entry are partially ordered; however, no assumptions 
should be made as to the relative placement or physical position of these 
associations in the alternate index record. 


Bytes and 
Offset Bit Patten Field Name Description 
0 (0) 2 Control information. 
2 (2) 1 TYPE Record type pointed to by the following 
control interval number. 
3 (3) 3 NAME Control interval number. 
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The association ordering by record type is: 


Record Type 


D 


Password Set of Fields Format 


Description 


Alternate index data (D) component association with occurrence 
sequence number = 1 


Alternate index index (I) component association with occurrence 
sequence number = 2 


Base cluster (C) component association with occurrence sequence 
number = 3 


Maximum of 252 path (R) associations 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 


Offset 
0 (0) 


2 (2) 


34 (22) 


42 (2A) 


44 (2C) 


52 (34) 


Bytes and 
Bit Pattern 


2 


a2 


VL 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 
Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

| Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the clusters DSNAME. 


Maximum number of attempts allowed for 
the operator or TSO operator to provide the 
correct password. 


Name of the user's security-verification 
module, if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 
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Path Catalog Record Format 


The path record describes an alternate index and its associated base data set 
to give an alternate, logical view of the base data set. It also may be used as 
an alias for a base data set to inhibit upgrade set unit allocation. 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) | Zeros. 

1(1) 3 ENTIDNO Control interval number of this record. 

4 (4) 1 RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 

5 (5) 6 CRAVOL CRA (catalog recovery area) volume serial. 

11 (B) 3 CRAIDNO CRA control interval number. 

14 (E) 4 CRADEVT CRA device type. 

18 (12) 4 CRACRETS CRA creation time stamp. 

22 (16) 4 Zeros. 

26 (1A) | SECFLAGS Security attributes. 

| neers Indicates record is RACF-protected. 
oXXX XXXX Reserved. 

27 (1B) 17 Zeros. 

44 (2C) | ENTYPE Record type—‘‘R.”’ 

45 (2D) 2 Record length. 

47 (2F) 1 Number of variable-length fields that precede 
the address of an extension record (always 
zero). 

48 (30) 1 Length of nonrepeating fixed-length fields 
(always X‘6C’). 

49 (31) 44 ENTNAME Name of the path described by this record. 

93 (5D) 8 OWNERID Owner of the path; specified when the path 
was defined. 

101 (65) 3 DSETCRDT Path creation date; in the packed-decimal 
form YDD. 

104 (68) 3 DSETEXDT Path expiration date; in the packed-decimal 
form YDD. 

107 (6B) | RGATTR Path attributes: 

Lae eese Include upgrade set during unit allocation 
and when opening this path. 
.XXX XXXX Reserved. 


The following 6-byte entry contains control information for the sets of fields that follow it. 


108 (6C) 5 Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 
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Path Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 


113 (71) 1 The number of set of fields pointers that 
follow.! 


Note: The first set-of-fields pointer might be 
special (meaning that the field-name 
dictionary permits catalog management to 
locate information that is not contained in 
catalog records); if so, its sequence number = 
0 and type code = 0. When bytes 0 to 2 are 
nonzero, this set-of-fields pointer points to 
the first (vertical) extension record that 
contains free space. The set-of-fields pointer 
is called the ASPT—available-space pointer. 
When bytes 0 to 2 are zero, the pointer is a 
dummy set-of-fields pointer—not available to 
be used to point to a set of fields. 


114 (72) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to by code. For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 


VL 5-byte pointers to sets of fields contained in 
vertical extension records. 


Byte Meaning 


0-2 Control interval number of the 
extension record that contains this 
set of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a type (group) 
code that describes set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a code of 2 are in one sequence. 

1 Fields describing (a) the control interval number of a Data or Index catalog record associated with this 


cluster, or (b) the password information associated with a data set are grouped into sets of fields. Pointers to 
each set of fields identify the type of information contained in each set of fields. 
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Association Set of Fields Format 


The associations in this entry are ordered in the sense that each association 
occurrence has a defined group occurrence sequence number; however, no 
assumptions should be made as to the relative placement or physical position 
of these associations in the path record. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
2 (2) 1 TYPE Record type which is pointed to by the 
following control interval number. 
3 (3) 3 NAME Control interval number. 


If this record describes a path over an alternate index, the association 
ordering by record type is: 


Record Type _ Description 


G Alternate index (G) entry association with occurrence 
sequence number = 1 


D Alternate index data (D) component association with occurrence 
sequence number = 2 


J Alternate index index (I) component association with occurrence 
sequence number = 3 


D Base data (D) component association with occurrence sequence 
number = 4 


J Base index (I) component association with occurrence sequence 
number = 5. This association exists only if the base cluster is a 
key-sequenced data set. 


If this record describes a path over a base cluster, the association ordering by 
record type is: 


Record Type Description 


C Base cluster (C) component association with occurrence sequence 
number = 1 


D Base data (D) component association with occurrence sequence 
number = 2 


I Base index (I) component association with occurrence sequence 
number = 3. This association exists only if the base cluster is a 
key-sequenced data set. 
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Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 
Bytes and 

Offset Bit Pattern 

0 (0) 2 

2 (2) 32 

34 (22) 8 

42 (2A) 2 

44 (2C) 8 

52 (34) VL 
Upgrade Catalog Record Format 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set's DSNAME. 


Maximum number of attempts allowed for 
the operator or TSO operator to provide the 
correct password. 


Name of the user’s security-verification 
module, if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 


The upgrade record describes all the alternate indexes that make up the 
upgrade set. It is pointed to by an association in the base data component. 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


Bytes and 
Bit Pattern 


1 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial number. 
CRA control interval number. 
CRA device type. 

CRA creation time stamp. 
Zeros. 

Record type—‘‘Y.”’ 

Record length. 


Number of variable-length records that 
precede the pointer to an extension record 
(always zero). 


Length of nonrepeating fixed-length fields 
(always X‘31’). 
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Upgrade Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 


The following 6-byte entry contains control information for the sets of fields that follow it. 


49 (31) 5 Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


54 (36) 1 The number of set of fields pointers that 
follow. 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 
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Upgrade Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattemm Field Name 
55 (37) VL 
VL 


Description 
5-byte pointers to sets of fields within the 


record. 


Byte 


Meaning 
Reserved. 


Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


Sequence number of the set of fields 
pointed to by code. For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 


5-byte pointers to sets of fields contained in 
vertical extension records. 


Byte 
0-2 


Meaning 


Control interval number of the 
extension record that contains this 
set of fields. 


Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a type (group) 
code that describes set of fields 
pointed to. 


Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a code of 2 are in one sequence. 


1 Fields describing (a) the control interval number of a Data or Index catalog record associated with this 
cluster, or (b) the password information associated with a data set are grouped into sets of fields. Pointers to 
each set of fields identify the type of information contained in each set of fields. 


a 
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Association Set of Fields Format 


The associations in this entry are an extension of the Release 1 format; they 
are actually twin associations consisting of a Release 1 data association and a 


Release 1 index association. 


Offset 
0 (0) 
2 (2) 


3 (3) 


6 (6) 


7 (7) 


Bytes and 
Bit Pattern 


2 
1 


1 


Field Name 


TYPE 


NAME 


TYPE2 


NAME2 


J 


Description 
Control information. 


‘“—D,” which indicates the following control 
interval number is for the data component of 
an alternate index in the upgrade set. 


Control interval number of the alternate 
index data component. 


*T,”’ which indicates the following control 
interval number is for the index component 
of an alternate index in the upgrade set. 


Control interval number of the alternate 
index index component. 


These twin associations exist only in upgrade records (type ‘“Y’’), and the set 
of twin aSsociations in any given upgrade record entry is always unique. 


NonVSAM Catalog Record Format 


The NonVSAM catalog record describes a data set organized differently from 
VSAM data set organization. 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


49 (31) 


93 (SD) 
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Bytes and 
Bit Pattern 


1 
3 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


ENTNAME 


OWNERID 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
O=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number.! 
CRA device type.! 

CRA creation time stamp. 


Zeros. 


Record type—‘A 
Record length. 


Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero for a NonVSAM catalog record. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 93 (X‘5D’). This 
value is always equal to the displacement 
from the beginning of the record to the 
pointer to an Extension record. 


DSNAME of the nonVSAM data set 
described by this record. 


Owner of the data set; specified when the 
data set was defined. 


2 


NonVSAM Catalog Record Format (continued) 


Offset 
101 (65) 


104 (68) 


Bytes and 
Bit Pattern 


3 


3 


Description 


Data set creation date, in packed-decimal 
form YDD, the date the data set was defined. 


Data set expiration date, in packed-decimal 
form YDD, specified when the data set was 
defined. 


The following 6-byte entry contains control information for the set of fields that follow it. 


107 (6B) 


112 (70) 


113 (71) 


5 


1 


VL 


Pointer to the horizontal Extension record. If 
this record is not continued on an Extension 
record, this field contains zeros. 


The number of set of fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
set on, the set of fields associated 
with this pointer has been deleted; 
the type (group) code in bits 2 
through 7 and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to. 
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NonVSAM Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 
VL 5-byte pointers to sets of fields contained in 


vertical extension records. 
Byte Meaning 


0-2 Control interval number of the 
extension record that contains this 
set of fields. 


3 Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a type (group) 
code that describes the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to. 


1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 

2 Fields describing (a) the volumes on which the data set resides, (b) the first Alias record in the Alias record 
chain for the nonVSAM data set, or (c) if the nonVSAM data set is a generation data set, the GDG Base 
record are grouped into sets of fields. Pointers to each set of fields identify the type of information 
contained in the set of fields. 


Association (Alias) Set of Fields Format 


The control interval number of the first alias catalog record in the alias record 
chain associated with the nonVSAM catalog record is contained in the 
association set of fields. This set of fields is associated with a pointer that 
contains a type (group) code of 2. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields. 
| Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 
2 (2) 1 TYPE “*X,” which indicates that this record is 
associated with an Alias record. 
3 (3) 3 NAME Control interval number of the first Alias 


record in the Alias record chain associated 
with this record. 


304 OS/VS2 Catalog Management Logic 


Association (GDG Base) Set of Fields Format 


If the nonVSAM data set is a generation data Set, it is associated with a 
generation data group. The control interval number of the generation data 
group (GDG) base catalog record is contained in the association set of fields. 
This set of fields is associated with a pointer that contains a type (group) code 


of 2. 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 

Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 

2 (2) l TYPE **B,”’ which indicates that this record is 
associated with a GDG Base record. 
3 (3) 3 NAME Control interval number of the GDG Base 


record associated with this record. 


Volume Information Set of Fields Format 


Each volume that contains space allocated to the nonVSAM data set is 
described by a volume information set of fields. This set of fields is associated 
with a pointer that contains a type (group) code of 3. 


Bytes and 
Offset Bit Pattern Field Name Description 


0 (0) Z Control information. 
Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

| Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 


2 (2) 4 DEVTYP Device type. 
6 (6) 6 VOLSER Volume serial number. 


12 (C) 2 FILESEQ File sequence number. (This field is provided 
for compatibility with the OS/VS catalog, 
and is used for nonVSAM data sets that 
reside on tape volumes. ) 


14 (E) 1 VOLFLG Volume flags, as follows: 


| hears Prime, which indicates that this volume was 
allocated when the data set described by this 
record was defined. 

os ees Overflow, which indicates that this volume is 
being used by the data set, but this volume 
was not allocated when the data set was 


defined. 
oX.X XXXX Reserved. 
15 (F) 3 DSCBTTR If the nonVSAM data set resides entirely on 


one volume, the DSCBTTR contains the 
location (TTR) of the data set’s Format 1 
DSCB in the volume’s VTOC. 
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Alias Catalog Record Format 


The alias catalog record allows a user to refer to a nonVSAM data set or 
user’s catalog with an alternate DSNAME. If the data set or catalog has more 
than one alias, each alias is described in an alias catalog record. All alias 
catalog records associated with the data set or catalog are chained together. 


Offset 
0 (0) 
1(1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


49 (31) 


Bytes and 
Bit Pattern 


1 


44 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


ENTNAME 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number.! 
CRA device type.! 

CRA creation time stamp. 
Zeros. 

Record type—‘*X.”’ 
Record length. 


Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero for an Alias catalog record. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 93 (X‘5D’). 


Alternate DSNAME (alias) of a nonVSAM 
data set or OS/VS2 user catalog. 


The following 6-byte entry contains control information for the set of fields that follow it. 


93 (SD) 


98 (62) 
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5 


1 


Pointer to the horizontal extension record. 
The Alias catalog record is never continued 
on an extension record, so this field contains 
Zeros. 


The number of set of fields pointers that 
follow.2 


Alias Catalog Record Format (continued) 


Offset 
99 (63) 


Bytes and 
Bit Pattern 


VL 


Field Name 


Description 


5-byte pointers to sets of fields within the 


record. 
Byte 

0 

1-2 


4 


Meaning 
Reserved. 


Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


Bits 0 and 1 are set to zero. If bit 1 is 
set on, the set of fields associated 
with this pointer has been deleted; 
the type (group) code in bits 2 
through 7 and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


Sequence number of the set of fields 
pointed to. 


1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 

2 Fields describing (a) the NonVSAM or User-Catalog catalog record that describes the object for which this 
DSNAME is an alternate DSNAME (alias), or (b) previous and next Alias records in the Alias record chain 
are grouped into sets of fields. Pointers to each set of fields identify the type of information contained in 
the set of fields. 


Association (User-Catalog or NonVSAM) Set of Fields Format 


The control interval number of the catalog record that contains the user 
catalog’s or nonVSAM data set’s real DSNAME is contained in the Alias 
catalog record’s first association set of fields. This set of fields is associated 
with a pointer that contains a type (group) code of 2. 


Offset 
0 (0) 


2 (2) 


3 (3) 


Bytes and 
Bit Pattern 


2 


1 


3 


Field Name 


TYPE 


NAME 


Description 


Control information. 


Byte 
0 


Meaning 


Count of the number of 
variable-length fields in this set of 
fields. 

Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 


“U,”’ which indicates that this record is 
associated with a User-Catalog record, or 
‘*A,” which indicates that this record is 
associated with a NonVSAM record. 


Control interval number of the User-Catalog 
or NonVSAM record associated with this 


record. 
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Association (Alias) Set of Fields Format 


The control interval number of the next and previous alias catalog record in the 
alias record chain is contained in the association sets of fields, respectively. 
These sets of fields are associated with pointers that contain a type (group) 
code of 2. 


If the Alias record is the first record in the Alias record chain, its second (next 
pointer) Association set of fields’ NAME field contains zeros. 


If the Alias record is the last record in the Alias record chain, its third 
(previous pointer) Association set of fields’ NAME field contains zeros. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields. 
1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


2 (2) l TYPE **X,”’ which indicates that this record is 
associated with a Alias record. 


3 (3) 3 NAME Control interval number of the Alias record 
associated with this record. 


Generation Data Group (GDG) Base Catalog Record 


Format J 


The GDG base catalog record allows a user to build and refer to generation 
data groups. The GDG base catalog record contains an association set of 
fields for each generation data set in the group. 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 1 Zeros. 

1 (1) 3 ENTIDNO Control interval number of this record. 

4 (4) 1 RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 

5 (5) 6 CRAVOL CRA volume serial. ! 

11 (B) 3 CRAIDNO CRA control interval number. ! 

14 (E) 4 CRADEVT CRA device type.! 

18 (12) 4 CRACRETS CRA creation time stamp. 

22 (16) 22 Zeros. 

44 (2C) | ENTYPE Record type—‘‘B.” 

45 (2D) 2 Record length. 

47 (2F) 1 Number of variable-length fields that precede 
the pointer to an Extension record. Always | 
for a GDG Base catalog record. 

48 (30) 1 Length of the fixed-length fields in this 


record, excluding any fixed-length fields 
following displacement 109 (X’6D). - 
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GDG Base Catalog Record Format (continued) 


Offset 
49 (31) 


93 (SD) 


101 (65) 


104 (68) 


107 (6B) 
108 (6C) 


109 (6D) 


Bytes and 
Bit Pattern 


44 


» -XXXXXX 


VL 


Field Name 
ENTNAME 


OWNERID 


DSETCRDT 


DSETEXDT 


GDGLIMIT 
GDGATTR 


GENLVLS 


Description 


DSNAME of the generation data group 
described by this record. 


Owner of the generation data group; 
specified when it was defined. 


Creation date, in packed-decimal form YDD. 
The date the generation data group was 
defined. 


Expiration date, in packed-decimal form 
YDD, specified when the generation data 
group was defined. 


Maximum number of GDG levels 
GDG attributes: 


Indicates how many data sets to delete from 
the catalog when GDGLIMIT is exceeded: 
O-delete oldest one; 

1-delete all. 

Indicates whether to scratch the deleted data 
set(s)’s format-1 DSCB: 

0Q-don't scratch; 

l-scratch. 

Reserved. 


Generation level difference string 


The following 6-byte entry contains control information for the set of fields that follows it. 


¥ 


Pointer to the horizontal Extension record. If 
this record ts not continued on an Extension 
record, this field contains zeros. 


The number of set of fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 
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GDG Base Catalog Record Format (continued) 


Bytes and 
Offset Bit Patten Field Name Description ) 
VL 5-byte pointers to sets of fields within the 

record. 

Byte Meaning 

0 Reserved. 

1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 

3 Bits 0 and 1 are set to zero. If bit 1 is 
set on, the set of fields associated 
with this pointer has been deleted; 
the type (group) code in bits 2 
through 7 and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 

4 Sequence number of the set of fields 
pointed to. 

VL 5-byte pointers to sets of fields contained in 
vertical extension records. 

Byte Meaning 

0-2 Control interval number of the 
extension record that contains this 
set of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 : 
through 7 contain a type (group) } 
code that describes the set of fields 
pointed to. 

4 Sequence number of the set of fields 
pointed to. 


1 Zeros if the catalog is not recoverable or if there is no associated CRA entry. 

2 Fields describing each generation (nonVSAM) data set in the generation data group (GDG) are grouped 
into sets of fields. Pointers to each set of fields identify the type of information contained in the set of 
fields. 
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Association (NonVSAM) Set of Fields Format 


The control interval number of the nonVSAM catalog record that describes 
one of the generation data sets in the generation data group is contained in 
the association set of fields. This set of fields is associated with a pointer that 
contains a type (group) code of 2. 


Bytes and 
Offset Bit Pattern Field Name Description 


0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 


2 (2) 1 TYPE **A,” which indicates that this record is 
associated with a NonVSAM record. 


3 (3) 3 NAME Control interval number of the NonVSAM 
record associated with this record. 


6 (6) 4 GENLEVEL Generation level—the ‘xxxx’ field in the 
generation data sett DSNAME 
**dsname.gxxxxvyy’. 


User-Catalog Catalog Record Format 


The User-Catalog catalog record describes a user catalog. 


Bytes and 
Offset Bit Patten Field Name Description 
0 (0) 1 Zeros. 
1 (1) 3 ENTIDNO Control interval number of this record. 
4 (4) 1 RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 
5 (5) 6 CRAVOL CRA volume serial.! 
11 (B) 3 CRAIDNO CRA control interval number. ! 
14 (E) 4 CRADEVT CRA device type. ! 
18 (12) 4 CRACRETS CRA creation time stamp. 
22 (16) 22 Zeros. 
44 (2C) 1 ENTYPE Record type—"U.”’ 
45 (2D) 2 Record length. 
47 (2F) 1 Number of variable-length fields that precede 


the pointer to an Extension record. Always 
zero for a User Catalog catalog record. 


48 (30) 1 Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 93 (X‘5D’). This 
value is always equal to the displacement 
from the beginning of the record to the 
pointer to an Extension record. 


49 (31) 44 ENTNAME DSNAME of the user catalog described by 
this record. 
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User-Catalog Catalog Record Format (continued) 


Bytes and 
Offset Bit Patten Field Name Description ) 
The following 6-byte entry contains control information for the sets of fields that follow it. 


93 (SD) 5 Pointer to the horizontal Extension record. 
The User Catalog catalog record record is 
not continued on an Extension record, so this 
field contains zeros. 


98 (62) 1 The number of set-of-fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


99 (63) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved 


1-2 Displacement of the set of fields from 
the beginning of all sets of fields in 
this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to. 
1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 
2 Fields describing (a) the volume on which the user’s catalog resides or, (b) the first alias in the Alias record 


chain for a user’s catalog are grouped into sets of fields. Pointers to each set of fields identify the type of 
information contained in the set of fields. . 
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Association (Alias) Set of Fields Format 


The control interval number of the first Alias record in the Alias catalog 
record chain associated with the user-catalog catalog record is contained in 
the association set of fields. This set of fields is associated with a pointer that 
contains a type (group) code of 2. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields. 
1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


2 (2) 1 TYPE **X,”’ which indicates that this record is 
associated with a Alias record. 


3 (3) 3 NAME Control interval number of the first alias 
record in the alias record chain associated 
with htis record. 


Volume Information Set of Fields Format 


Each volume that contains space allocated to the user catalog is described by 
a volume information set of fields. This set of fields is associated with a 
pointer that contains a type (group) code of 3. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 

Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 

2 (2) 4 DEVTYP Device type. 
6 (6) 6 VOLSER Volume serial number. 
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Volume Catalog Record Format 


The Volume record describes VSAM data spaces, their extents, and the data 
sets that reside in VSAM data spaces. J 
Bytes and 

Offset Bit Pattem Field Name Description 

0 (0) | Zeros. 

1 (1) 3 ENTIDNO Control interval number of this record. 

4 (4) 1 RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 

5 (5) 6 CRAVOL CRA volume serial.! 

11 (B) 3 CRAIDNO CRA control interval number. ! 

14 (E) 4 CRADEVT CRA device type.! 

18 (12) 4 CRACRETS CRA creation time stamp. 

22 (16) 22 Zeros. 

44 (2C) 1 ENTYPE Record type—‘‘V.” 

45 (2D) Z Record length. 

47 (2F) 1 Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero for a Volume catalog record. 

48 (30) 1 Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 127 (X‘7F’). This 
value is always equal to the displacement 
from the beginning of the record to the ) | 
pointer to an Extension record. 

49 (31) 44 ENTNAME 8-byte volume serial number, filled with 36 
bytes of binary zeros on the right, of the 
volume described by this record. 

93 (SD) 8 VOLSTMP Volume time stamp, which indicates when 


314 OS/VS2 Catalog Management Logic 


the first VSAM data space was defined on 
this volume. 
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By TNL SN26-0912 
Volume Catalog Record Format (continued) 
Bytes and 
Offset Bit Pattern Field Name Description 
101 (65) 20 VOLDVCHR Device characteristics. 

Byte Meaning 

0-3 Volume device type. 

47 Maximum device block size. 

8-9 Number of cylinders on this volume. 

10-11 Number of tracks per cylinder on 
this volume. 

12-13. Number of bytes per track on this 
volume. 

14 Number of bytes required for gaps 
and check bits for each keyed block 
other than the last block on a track 
for this volume.2 

15 Number of bytes required for gaps 
and check bits for the last keyed 
block on a track for this volume. 2 

16 Number of bytes to be subtracted for 
a block that is not keyed.2 

17 Flags. Bits 0 through 6 are reserved. 
If bit 7 is set to 1, use tolerance factor 
on all blocks but the last to calculate 
the effective length of a block.2 

18-19 Tolerance factor to be used in 
calculating the effective length of a 
block. 

121 (79) 1 VOLRFLG Volume record flags. 

122 (7A) | SYSEXTDS Number of extents per suballocation request 
allowed by the OS/VS system. 

123 (7B) 4 Reserved. 


The following field names identify information that is not contained in the volume catalog 
record, the information is derived from fields in the volume catalog record. 


Zz NODSPACE Number of data spaces on the volume—a 
count of the Data Space Group sets of fields. 


2 NODSET Number of data sets on the volume—a count 
of the Data Set Directory Entry sets of fields. 


The following 6-byte entry contains control information for the sets of fields that follow it. 


127 (7F) 5 Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


| 132 (84) | Number of set-of-fields pointers that follow. 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
O to 2 are zero, the pointer is adummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 
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Volume Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 
| 133 (85) VL 6-byte pointers to sets of fields within the 
record. 

Byte Meaning 

0 Reserved. 

1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 

3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in bytes 4 and 5, however, are kept. 
Bits 2 through 7 contain a type 
(group) code‘, describing the set of 
fields pointed to. 

4-5 Sequence number of the set of fields 
pointed to. 

VL 6-byte pointers to sets offields contained in 


vertical Extension records. 
Byte Meaning 


0-2 Control interval number of the 
extensior record that contains this 
set of fields. 


3 Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 


45 Sequence number of the set of fields 
pointed to. 


Zeros if the catalog is not recoverable or if there is no associated CRA volume. 

This value is used to calculate overhead bytes for keyed blocks to provide for compatibility with the 
DEVTYPE macro instruction. Blocks used by VSAM are, however, not keyed blocks. 

Fields describing (a) the volume’s tracks’ allocated/unallocated status, (b) each VSAM data space on the 
volume, and (c) each VSAM data set that resides in a VSAM data space are grouped into sets of fields. 
Pointers to each set of fields identify the type of information contained in each set of fields. 

If the pointer is associated with track status (space map) information, the type (group) code is 5; with data 
space information, the type (group) code is 6; with a data set directory entry, the type (group) code is 8. 
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Space Map Set of Fields Format 


The tracks on a VSAM volume are allocated to a VSAM object, or are 
unallocated, as described by the Space Map set of fields. Each bit position 
describes one track as allocated (bit = 0) or unallocated (bit = 1). This set of 
fields is associated with a pointer that contains a type (group) code of 5. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control Information: 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields (X‘01’). 


1 Hexadecimal displacement to the 
variable-length field, from the 
beginning of the set of fields (X‘02’). 


2 (2) VL BITMAP Portion of the volume bit map (1 to 440 bytes 
describing the allocated or unallocated status 
of 1 to 3520 direct-access device tracks). 


Data Space Group Set of Fields Format 


Each VSAM data space on the volume is described with a Data Space Group 
set of fields. This set of fields is associated with a pointer that contains a type 
(group) code of 6. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields (X‘00’). 
1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields (X‘55’). 


2 (2) 8 DSCBTS Format-1 DSCB time stamp, which indicates 
when the DSCB was created. The time stamp 
is part of the name given to the Format-1 
DSCB. 


10 (A) 5 DSCBPTR CCHHR of the Format-1 DSCB. 
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Volume Catalog Record Format: Data Space Group Set of Fields Format 


(continued) 
Bytes and 
Offset Bit Pattern 
15 (F) 1 
| eee 
0... 
2132 
1... 
XX .XXX 
16 (10) 1 
17 (il) 1 
LOLS: sue 
Pie ade 
.XX XXXX 
20 (14) 3 
23 (17) 64 
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Field Name 
SPHDFLG 


NODSPEXT 
DSPSOPT 


DSPSSQ 


SPEXTENT 


Description 


Data-space flags. 


Unique data space—this data space contains 
all or part of only one VSAM object. 
Shared data space—this data space contains 
all or part of two or more VSAM objects. 
Automatically built data space—this data 
Space was built as a result of an end of 
volume request for additional space. 

This data space was built when the user 
issued an Access Method Services DEFINE 
CATALOG command, and contains an 
OS/VS2 catalog. 

Reserved. 


Number of extents in this data space. 


Space options specified when the data space 
was created. 


Track request—primary space allocation is 
specified in tracks. 

Cylinder request—primary space allocation 
is specified in cylinders. 

Reserved. 


Secondary space allocation quantity by which 
space is to be extended if required. This value 
is taken either from an Access Method 
Services DEFINESPACE command or from 
the first non-unique data set on this volume 
that caused space to be used. 


Jo 


Sixteen 4byte extent descriptors in the form 


TTNN: 

TT starting track number of the extent 
(relative to the beginning of the 
volume). 


NN number of tracks in the extent. 


Derived Data Space Information 


The following field names identify information that is expected, but not 
contained in, the Data Space Group set of fields. The information is derived 
from fields in the volume catalog record. 


Bytes and 
Offset Bit Pattern Field Name Description 


1 SPHDFLG Data space flags: 


whe; wis A user catalog has extents within this data 
space—each CAXWA associated with the 
user contains the volume serial number of its 
catalog. 

sya aud A master catalog has extents within this data 
space—the master catalog’s volume is 
identified by a Data Set Directory Entry set 
of fields that contains a control interval value 
of 002. 


XX.. XXXX Reserved. 


2. NODSDSP Number of data sets in the data space—this 
information is derived by searching each 
Data and Index catalog record (pointed to by 
Data Set Directory Entry sets of fields and 
Cluster catalog records) for a volume 
information set of fields that contains the 
volume’s serial number. Each set of fields so 
identified is searched to determine if the data 
set or index has been allocated space in one 
of the data space’s extents. 


The following field names refer to information about an extent of the data space: 


2 TRKSUSED Number of allocated tracks in the 
extent—the Space Map set of fields is 
scanned to determine the number of 
allocated tracks, based on the extent’s 
starting track number and total number of 
tracks (contained in SPEXTENT). 


4 EXTSTART Cylinder and track on which the extent 
begins—the extent’s TT value (contained in 
SPEXTENT) is converted to a CCHH value. 


2 NOTRKEXT Number of tracks in the extent—the extent’s 
NN value (contained in SPEXTENT). 
2 SNSPHD Sequence number of the set of fields that 


describes the extent’s data space—the 
sequence number of the Data Space Group 
set of fields. 


VL SPACEMAP A variable-length space map that defines the 
allocated and unallocated space in the 
extent—the Space Map set of fields is 
converted to the format of this 
variable-length field based on the extent’s 
starting track number and total length 
(contained in SPEXTENT). 
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Data Set Directory Entry Set of Fields Format 


Each data set that resides in a VSAM data space on the volume is described 
with a Data Set Directory Entry set of fields. This set of fields is associated ) 
with a pointer that contains a type code of 8. 


Bytes and 
Offset Bit Pattern Field Name Description 


0 (0) 2 Control information. 
Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields (X‘00’). 

| Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields (X‘05’). 


2 (2) 3 DSIDNO Control interval number of the Data or Index 
catalog record that describes this data set or 
index. 


5 (5) 4 DSCRETS Data/index identifier creation time stamp. 
Initialized by DEFINE and never altered. 
Consists of the high-order 4 bytes of the 
TOD clock value. 


9 (9) 3 DSSUMTT Sum of TT values converted from starting 
CCHHs of all extents of this data set on this 
volume. 


Derived Data Set Information 


The following field names identify information that is expected, but not | 
contained in, the Data Set Directory Entry set of fields. The information is ; 
derived from fields in the volume catalog record. 


Bytes and 
Offset Bit Pattern Field Name Description 
| MODSEXT Number of data set extents on this volume. 
| DSDIRFLG Flags: 
Bit Meaning 
Is eas The Data or Index catalog record identifies 
the volume as a candidate volume—the Data 
Set’s or Index’s catalog record is searched; its 
volume information set of fields has zero 
extents. 
VL DSSPSN A variable-length collection of 3-byte fields 


that identify each data space within which 
the data set has extents allocated to it—this 
information is obtained by converting each 
volume information set of fields’ extent 
descriptor’s (EXTENT) SS value (data space 
extent’s sequence number) so that the 
resulting 3-byte field is: 


Byte Meaning 


0-1 Sequence number of the Data Space 
Group set of fields. 
2 Number of extents (groups of 


contiguous tracks) assigned to the 
data set or index from the data space 
(limits: 1-255). 
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Extension Catalog Record Format 


The Extension record contains overflow information from another catalog 


record. 


Bytes and 
Offset Bit Pattern 


0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 


45 (2D) 
47 (2F) 


48 (30) 


1 
3 
1 


+ ff WD 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number.! 
CRA device type.! 

CRA creation time stamp. 
Zeros. 


Record type—a ““W”’ if this extension record 
is an extension of a Volume catalog record; 
an “E” if this extension record is an 
extension of any other type of catalog record. 


Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero for an extension catalog record. 


Length of the fixed-length fields in the 
header fields, excluding any fixed length 
fields following displacement 49 (X‘31’). This 
value is always equal to the displacement 
from the beginning of the record to the 
extension record’s pointer. 


The following 6-byte entry contains control information for the sets of fields that follow it. 


49 (31) 


54 (36) 


55 (37) 


5 


1 


VL 


Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


The number of set-of-fields pointers that 
follow. 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record. If the extension record’s identifier is 
““W”’ (the record extends a volume catalog 
record), these are 6-byte pointers. The 
sequence number in each 6-byte pointer is 
two bytes long. 
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Extension Catalog Record Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to.3 


4or Sequence number of the set of fields 
4-5 pointed to, by type (group) code.3 


VL 5-byte pointers to sets of fields contained ina 
vertical Extension record. If the Extension 
record's identifier is ‘“W”’ (the record extends 
a volume catalog record), these are 6-byte 
pointers. The sequence number in each 
6-byte pointer is two bytes long. 


Byte Meaning 

0-2 Control interval number of the 
Extension record that contains this 
set of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a type (group) 
code that describes the set of fields 
pointed to. 


4or Sequence number of the set of fields 
4-5 pointed to, by type (group) code.3 


1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 

2 Fields describing (a) the volumes on which a data set resides, and (b) the password information associated 
with a data set are grouped into sets of fields. Pointers to each set of fields identify the type of information 
contained in each set of fields. 

The sets of fields that are contained in an extension record depend upon the kind of catalog record that is 
extended. The format of the remainder of an extension record is, therefore, variable. The sets of fields in an 
extension record are, however, in the same format as they would be in the base record. 


we 
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CRA Free Record Format 


The CRA Free record indicates that the control interval in which it resides is 
free and points to the next control interval that is free because of deletion. 
Note that the Free CRA record is used only to mark a record that was used 
and has been deleted. The free space (control intervals) in the CRA that has 
never been assigned is not represented by Free CRA records. Control 
intervals 1,4,6,7, and 8 in the CRA are marked as Free records; however, 
their free control interval chain field is zero. 


Offset 
0 (0) 
1(1) 


4 (4) 

44 (2C) 
45 (2D) 
48 (30) 


CRA Data Record Format 


Bytes and 
Bit Pattern 


1 
3 


457 


Field Name 


ENTIDNO 


ENTYPE 


Description 
Reserved. 


Control interval number of this record: 
X‘QOO00N’ where N=1,4,6,7, or 8. 


Reserved. 
Record type—‘‘F.”’ 
Free control interval chain field. 


Reserved. 


The CRA Data record describes the CRA data component of the CRA 
cluster. The CRA Data record, which is record type ““D,”’ occupies control 


interval 0 in the CRA. 


Bytes and 
Bit Pattern 


Offset 
0 (0) 
1 (1) 


4 (4) 
5 (5) 
44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


49 (31) 


93 (SD) 
101 (65) 


104 (68) 
107 (6B) 
108 (6C) 
109 (6D) 
110 (6E) 
114 (72) 


1 
3 


39 


Field Name 


ENTIDNO 


RELIND 


ENTYPE 


ENTNAME 


OWNERID 
DSETCRDT 


DSETEXDT 
ATTRI 
ATTR2 
OPENIND 
BUFSIZE 
PRIMSPAC 


Description 

Zeros. 

Control interval number of this record: 
X‘000000’. 

Release indicator. 

Zeros. 

Record type—D.”’ 

Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of nonrepeating fixed-length fields. 
Always X‘8F’. 


Name of the catalog that owns this CRA 
volume. 


Initialized to all X‘FF’. 


Date CRA was created. In packed-decimal 
form YDD. 


Expiration date. Initialized to X‘OOOO0F’. 
Data set attributes: X‘00’. 

Data set attributes: X‘A0’. 

Open indicator: X‘00’. 

Minimum buffer size: X‘800’. 


Primary space. Initialized to number of 
tracks per cylinder. 
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CRA Data Record Format (continued) 


Bytes and 

Offset Bit Patten §_ Field Name Description J 

117 (75) 3 SCONSPAC Secondary space. Initialized to number of 
tracks per cylinder. 

120 (78) 1 SPACOPTN Space option: X‘80’. 

121 (79) 4 HURBADS High-used RBA. 

125 (7D) 4 HARBADS High-allocated RBA. 

129 (81) 4 LRECL Logical record size: X‘1F9’. 

133 (85) 2 USERINFO DOS user information: X‘00’. 

135 (87) 8 EXCPEXIT Exception exit Initialized to all X*FF’. 

The following entries contain control information for repeating fields: 

143 (8F) 5 Pointer to an extension record. Always zeros. 

148 (94) 1 The number of set-of-field pointers that 
follow. 

149 (95) VL Five-byte pointers to sets of fields. 


AMDSB (Access Method Data Statistics Block) Set of Fields 
Format 
The AMDSB set of fields contains a copy of the AMDSB control block that is 


updated each time the CRA is closed. This set of fields is associated with a 
pointer that contains a type (group) code of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. a 
Byte Meaning 
0 Count of the number of 
variable-length fields in this set of 
fields. 
1 Displacement (X*62’) to the first 


variable-length field from the 
beginning of this set of fields. 


2 (2) 96 AMDSBCAT Copy of the AMDSB. See “Data Areas’”’ for 
detailed information about the AMDSB. 


Association (Cluster) Set of Fields Format 


There is one association in this entry, and it has a group occurrence sequence 
number of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information: X*0006’. 
2 (2) 1 TYPE Record type—'‘C..”’ 
3 (3) 3 NAME Control interval number: X‘000002’. 


Volume Information Set of Fields Format 


There is one volume information set of fields in this entry. Its group 
occurrence sequence number is 1, and it resides in control interval number 5. ) 
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CRA Cluster Record Format 


This record describes the CRA cluster. It is record type ‘“‘C,”’ and it occupies 
control interval 2 in the CRA. 


Offset 
0 (0) 
1(1) 


4 (4) 
5 (5) 


44 (2C) 
45 (2D) 


47 (2F) 


48 (30) 


49 (31) 


93 (SD) 
101 (65) 


104 (68) 
107 (6B) 


Bytes and 
Bit Pattern 


1 
3 


39 


44 


3 
] 


Field Name 


ENTIDNO 


RELIND 


ENTYPE 


ENTNAME 


OWNERID 
DSETCRDT 


DSETEXDT 
CATTR 


Description 

Zeros. 

Control interval number of this record: 
X*000002’. 

Release indicator. 

Zeros. 

Record type—C.”’ 

Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of nonrepeating fixed-length fields: 
X‘6C’. 

Name of the catalog that owns this CRA 
volume. 


Initialized to all X‘FF’. 


Date CRA was created. In packed-decimal 
form YDD. 


Expiration date. Initialized to X‘OOOOOF’. 
Cluster attributes: X‘00’. 


The following entries contain control information for repeating fields: 


108 (6C) 
113 (71) 


114 (72) 


5 
1 


VL 


Association (Data) Set of Fields Format 


Pointer to an extension record. Always X‘00’. 


The number of set-of-field pointers that 
follow. 


Five-byte pointers to sets of fields. 


There is one association in this entry, and its group occurrence sequence 


number is 1. 


Offset 
0 (0) 
2 (2) 
3 (3) 


Bytes and 
Bit Pattern 


2 


1 
3 


Field Name 


TYPE 
NAME 


Description 
Control information: X‘0006’. 


Record type—‘*D. 
Control interval number: X‘000000’. 
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CRA Catalog Control Record Format 


The catalog control record is used to manage CRA control interval allocation. 
It is record type ‘‘L,”’ and it occupies control interval 3 in the CRA. 


Offset 
0 (0) 
1 (1) 


4 (4) 
5 (5) 

44 (2C) 
45 (2D) 


48 (30) 


51 (33) 
54 (36) 


57 (39) 
61 (3D) 
65 (41) 
69 (45) 


Bytes and 
Bit Pattern 


1 
3 


CRA Data Extension Record Format 


Field Name 


ENTIDNO 


RELIND 


ENTYPE 


Description 

Zeros. 

Control interval number of this record: 
X‘000003’. 

Release indicator. 

Zeros. 


Record type—"‘L. 


Number of the highest control interval within 
the current extents. 


Number of the next free control interval that 
has not been previously assigned. 


Number of deleted control intervals. 


First deleted control interval in a chain of 
control intervals that are free because of 
deletion. 


Reserved. 
CRA data high-used RBA. 
CRA data high-allocated RBA. 


Reserved. 


The Data Extension record is the extension of the CRA Data Record in 
control interval 0 of the CRA. The Data Extension record is record type “E,” 
and it occupies control interval 5 in the CRA. 


Offset 
0 (0) 
1(1) 


4(4) 
5 (5) 
44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


Bytes and 
Bit Pattern 


| 
3 


39 


Field Name 


ENTIDNO 


RELIND 


ENTYPE 


Description 
“Zeros. 
Control interval number of this record: 
X‘000005’. 
Release indicator. 
Zeros. 
Record type—“E.”’ 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of nonrepeating fixed-length fields: 
X‘6C’. 


The following entries contain control information for repeating fields: 


49 (31) 
54 (36) 


55 (37) 
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5 
1 


VL 


Pointer to an extension record. Always zeros. 


The number of sets-of-fields pointers that 
follows. 


Five-byte pointers to sets of fields within the 
record. 


J 


Volume Information Set of Fields Format 


Field Name Dictionary 


There is one volume information set of fields in this entry, and its group 
occurrence sequence number is 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information: X°0327’. 
2 (2) 4 DEVTYP Device type. 
6 (6) 6 VOLSER Volume serial number. 
12 (C) 2 FILESEQ File sequence number. 
14 (E) 1 VOLFLG Volume flags: X‘80’. 
15 (F) 1 NOEXTNT Number of extents. 
16 (10) 4 HKRBA High-key RBA. 
20 (14) 4 HURBA High-used RBA. 
24 (18) 4 HARBA High-allocated RBA. 
28 (1C) 4 PHYBLKSZ Block size: X*200’. 
32 (20) 2 NOBLKTRK Number of blocks per track. 
34 (22) 2 NOTRKAU Number of tracks per allocation unit. 
Initialized to number of tracks per cylinder. 
36 (24) 1 ITYPEXT Type-of-extent indicator. 
37 (25) 2 DSDIRSN Data set directory sequence number. 
39 (27) 2 LOKEYV Low key length on volume. 
41 (29) 2 HIKEYV High key length on volume. 
43 (2B) 2 EXTENT Length of extent information. 
45 (2D) VL 20-byte extent descriptors. 


The field name dictionary is an internal data area that provides a map 
between field names and fields within catalog records, as well as information 
that is not within catalog records. The dictionary also allows the dictionary 
user to specify values (for example, the number of sets of fields to be 
processed) by associating them with a dictionary name. A field name is 
specified in a CTGFL (field parameter list). For a description of the CTGFL, 
see “Data Areas.” The catalog management modules reference the field name 
dictionary for the location, length, and type of fields. 


The field name dictionary is a series of eight-byte entries. In addition, there is 
an index of combination field names. Each combination field name allows 
catalog management to locate more than one field at a time. 


The field-name dictionary is located in module IGGOCLAY. 
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Field Name Dictionary Entry Format (continued) 


Bytes and 
Offset Bit Pattern Description 


0 4 Shortened field name: the first, second, fifth, and sixth characters 
of the eight-character field name. 


4 1 Flags that describe the field. 


000. .... The field is fixed-length and appears in the header portion of a 
record (before the Extension record pointer). 

OO1. .... A combination field name.! 

010. .... The field is fixed-length and 1s part of a set of fields that follows 
the Extension record pointer. 

100. .... The field is variable-length and appears in the header portion of a 
record (before the Extension record pointer). 

110. .... The field is variable-length and is part of a set of fields that follows 
the Extension record pointer. 

O11. .... Special field.2 

|S ee Special field.2 

eo | Dare Not a flag field, which means that a CLC (compare logical 
character) instruction can be used to test this field. 

bel «xe Flag field, which means that a TM (test under mask) instruction 
can be used to test this field. 

\ Fe A fixed-length field within a variable-length field in a set of fields. 
0... Not a fixed-length field within a variable-length field in a set of 

fields. 

CRA updates are to be suppressed. 

CRA updates are not suppressed. 

This field must be retrieved from the upgrade set. 

This field has no special retrieval characteristics. 

eX Reserved. 


ea 


5 1 Bytes that identify the location of the field: 


Type of Contents of 
field name this byte 


Fixed-length: Displacement in bytes from 
in the header: the beginning of the record. 


in a set of 
fields: the beginning of the set of fields. 


in a group of 
fixed-length 
fields within 

a variable-length 


field: Length of the group of fixed-length fields. 
Variable-length: Zero. 
Combination: Index value in the combination-name index. 
6 1 Bytes that identify the location of the field (continued): 
Type of Contents of 
field name this byte 
Fixed-length: Length of the field (in bytes). 


Variable-length: | Sequence number of the field. 


Combination: Number of fields identified by 
the combination name. 
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Field Name Dictionary Entry Format (continued) 


Bytes and 

Offset Bit Pattern Description 

7 1 A code that indicates which group of data (the kind of 
catalog record and the set of fields) this field is in. 
Set of Fields Type Codes 
Type code: Description: 
0 Header field 
1 AMDSB 
2 Association 
3 Volume information 
4 Password 
5 Space map 3 
6 Data space group 3 
7 Reserved 
8 Data set directory? 


1 “Combination field name” indicates that the name supplied is a name that allows catalog 
management to locate a group of related fields. 
2 The field-name dictionary permits catalog management to locate information that is not 
contained in catalog records (for example, derived information). 
3 This set of fields is contained only in a Volume catalog record. 
Bytes 4 through 7 of the field-name dictionary record describe the field. 
When a caller makes a request in a CTGFL, dictionary information is moved 


from the dictionary to the CTGFL. 


To clarify the use of the dictionary as a means of gaining access to catalog 
information, refer to the examples that follow. 


Combination Field Names 


A combination field name identifies a group of related fields. When a catalog 
management user requires information from many catalog record fields (eg. 
all fields in a set of fields), the user builds a CTGFL that contains a 
combination field name. The combination field name in the CTGFL identifies 
an entry in the field name dictionary (in module IGGOCLAY). The entry 
identifies the field name as a combination field name, specifies the number of 
fields contained in the combination, and points to the starting point for the 
combination in the combination field name index. The combination field 
name index contains a group of 1-byte entries. Each entry points to an entry 
in the field name dictionary, as shown in Figure 41, Resolution of a 
Combination Field Name. The entry in the field name dictionary describes 
one of the fields identified by the combination. 


Field name 
dictionary 


Number of 
fields 


tCombination 
index 


Field 1 
(combination) 


Field 2 


Combination index 


t Field 2 
Field 3 t Field 3 the 


t Field 4 


Field 4 


Figure 41. Resolution of a Combination Field Name 
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Field Name Dictionary Entries 


This section lists the field name dictionary entries in alphabetic order. 
IGGOCLAY lists the field name dictionary entries in alphabetic order, too, 
but that list is ordered by abbreviated field name (first, second, fifth, and 
sixth characters of the field name). The field’s name, length, location, and 
description are listed here. 


The field’s location is coded as follows: 


Code Location description 


AMDSB The AMDSB set of fields 


Assoc The association set of fields 
Combin A combination field name 
Header The catalog record’s header fields. Note: some header fields appear in all 


catalog records; other header fields appear only in one (or more) type of 
catalog record. 


Password The password set of fields 

Special A piece of information that is derived from information in catalog record 
fields or catalog control blocks, but is not stored in a catalog record 

Vol Info The volume information set of fields 

Vol-Dir The data set directory entry set of fields in the volume catalog record 


Vol-DSG The data space group set of fields in the volume catalog record 


Vol-SM The space map set of fields in the volume catalog record 
Notes 


e The list of field names following each combination name in this section is 
ordered alpha-numerically. See module listing IGGOCLAY for the actual 
order of the combination’s field names. 


e Each variable-length field contains two bytes of control information 
followed by a number of data bytes. The 2-byte control information 
specifies the total length of the field. 


e The field’s length (len) is: 


t..? 


n’ anumber of bytes. 


“VL’ indeterminate, because the field is a variable length field. 


é , 


—’ indeterminate, because the combination name group of fields includes 
one or more variable-length fields. 


Field 

Name Len Location Description 

AMDCIREC 8 AMDSB AMDSB control-interval size and maximum logical 
record size (show catalog support); includes fields 
AMDCINV and AMDLRECL 

AMDKEY 4 AMDSB AMDSSBS relative key position and key length (show 
catalog support); includes fields AMDRKP and 
AMDKEYLN 


AMDSBCAT 96 AMDSB Copy of the AMDSB control block 
AMDSBSC 12 Combin AMDSSB fields for show catalog 
Includes fields: AMDCIREC, AMDKEY 


AMDSBI1 6 AMDSB Part of AMDSB 
AMDSB2 10 AMDSB Part of AMDSB 
AMDSB3 68 AMDSB Part of AMDSB 
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Field Name Dictionary Entries (continued) 


Field 
Name 


ASSOCSC 
ATTRI 
ATTR2 
BITMAP 


BUFSIZE 
CATACB 
CATTR 

CATVOL 


CNTREPNO 
CRACRETS 
CRADEVT 
CRADIRCT 


CRADITS 
CRAIDNO 
CRAVOL 
DATASPAC 


DEVTYP 
DEXTENTS 


DIRECTRY 


DSATRO 


DSATTR 


DSCBPTR 


DSCBTS 
DSCBTTR 


DSCRETS 


Len 


12 


85 


68 


Location 


Combin 
Header 
Header 
Vol-SM 


Header 
Special 
Header 


Combin 


Special 
Header 
Header 


Combin 


Header 
Header 
Header 


Combin 


Vol Info 


Combin 


Combin 


Combin 


Combin 


Vol-DSG 


Vol-DSG 


Vol Info 


Vol-Dir 


Description 


Twin associations for show catalog support 
Data set attributes 
Data set attributes 


Volume space map showing the allocated and 
unallocated tracks on a direct-access volume 


Minimum buffer size 
Address of the catalog’s ACB control block 
Cluster attributes 


Volume information set of fields for a nonVSAM 
data set’s catalog record 


Includes fields: DEVTYP, FILESEQ, RELREPNO, 
VOLFLG, VOLSER 


Maximum number of RELREPNOs to be processed 
CRA creation time stamp 

CRA device type 

Data set directory fields for catalog recovery 


Includes fields: DSCRETS, DSIDNO, DSSUMTT, 
RELREPNO 


Data/index identifier creation time stamp 
CRA control interval number 

CRA volume serial 

Data space group set of fields 


Includes fields: DSCBPTR, DSCBTS, DSPSOPT, 
DSPSSQ, NODSPEXT, SPEXTENT, SPHDFLG, 
RELREPNO 

Device type 


All fields in the data space group set of fields required 
by Suballocate processing 


Includes fields: NODSPEXT, SPEXTENT, 
SPHDFLG, RELREPNO 


Data set directory entry set of fields 
Includes fields: DSIDNO, RELREPNO 

All data set attributes flags fields 

Includes fields: ATTR1, ATTR2, OPENIND 


All data set attributes flags fields, except the open 
indicator 


Includes fields: ATTR1, ATTR2, OPENIND 


TTR of the DSCB that describes the data space in the 
volume’s VTOC 


Data space timestamp 


TTR of the format 1 (identifier) DSCB that describes 
the space allocated to a nonVSAM data set, if the 
entire data set resides on one volume. 


Data/index identifier time stamp 
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Field Name Dictionary Entries (continued) 


Field 
Name 


DSDIRECT 


DSDIRFLG 
DSDIRSN 


DSETCRDT 
DSETEXDT 
DSIDNO 


DSPDSCRP 


DSPSOPT 
DSPSSQ 
DSSPSN 


DSTYPNAM 


DSSUMTT 


ENT ASSOC 


ENTIDNO 
ENTNAME 
ENTUPGD 


ENTVOL 


ENTYPE 
EXCPEXIT 
EXTENT 
EXTSTART 
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Len 


VL 


37 


VL 


Location 


Combin 


Special 
Vol Info 


Header 
Header 
Vol-Dir 


Combin 


Vol-DSG 
Vol-DSG 


Special 


Combin 


Vol—Dir 


Combin 


Header 
Header 


Combin 


Combin 


Header 
Header 
Vol Info 
Special 


Description 


Data set directory entry set of fields, including some 
of the related derived fields 


Length: 7 + L-_DSSPSN 


Includes fields: DSDIRFLG, DSIDNO, DSSPSN, 
NODSEXT, RELREPNO 


Data set directory flags (derived) 


Data set directory sequence number in the volume 
information set of field’s extent descriptor 


Data set creation date 
Data set expiration date 


Control interval number of the data set directory 
entry's object’s catalog record 


Space descriptor set of fields (a group of derived 
fields) 


Includes fields: EXTSTART, NOTRKEXT, 
RELREPNO, SNSPHD, SPACEMAP, TRKSUSED 


Space options for a data space 
Secondary data space quantity 


Data space sequence numbers for the data set 
directory entry set of fields (derived) 


Catalog record type and dsname 
Includes fields: ENTIDNO, ENTYPE 


Sum of starting tracks of all extents of data set on this 
volume ; 


Association set of fields 

Includes fields: NAME, RELREPNO, TYPE 
Control interval number of the catalog record 
Dsname in the catalog record 

Combination for associations in the upgrade set 


Includes fields: NAME, NAME2, RELREPNO, 
TYPE, TYPE2 


Volume information set of fields 


Includes fields: DEVTYP, FILESEQ, HARBA, 
HKRBA, HURBA, ITYPEXT, NOBLKTRK, 
NOEXTNT, NOTRKAU, PHYBLKSZ, VOLFLG, 
VOLSER, RELREPNO, DSDIRSN, EXTENT, 
HIKEYV, LOKEYV 


Catalog record type identifier 
Exception exit 
Extent descriptors 


Starting point in the list of data space extents in the 
data space group set of fields (derived) 


| 


Field Name Dictionary Entries (continued) 


Field 
Name 


EXTVOL 


FILESEQ 
GDGATTR 
GDGLIMIT 
GDGLVLIM 


GDGNAME 


GENDSP 
GENLEVEL 
GENLVLS 
HARBA 
HARBADS 


HIKEYV 


HKRBA 


HKURBA 


HURBA 
HURBADS 


ITYPEXT 


LOKEYV 


LRECL 
MAPSPACE 


NAME 
NAME2 


Len 


VL 


VL 


Location 


Combin 


Vol Info 
Header 
Header 


Combin 


Combin 


Special 
Assoc 
Header 
Vol Info 
Header 


Vol Info 


Vol Info 


Combin 


¢ 


Vol Info 
Header 


Vol Info 


Vol Info 


Header 


Combin 


ASSOC 


Assoc 


Description 


Volume information set of field’s fields required for 
VSAM End of Volume processing 


Length: 7 + LEXTENT 


Includes fields: DEVTYP, EXTENT, ITYPEXT, 
RELREPNO 


File sequence number for a nonVSAM data set 
GDG attributes flag 
Maximum number of GDG levels allowed 


Fields required to determine the number of cataloged 
generations in a GDG (generation data group) 


Length: 1 + LGDGLVLS 
Includes fields: GDGLIMIT, GDGLVLS 


Association set of fields for a generation data group 
(GDG) 


Includes fields: GENLEVEL, NAME, TYPE 
Generated data space dsname 

GDG generation level—_GGGG 

Generation level difference string 

High-allocated RBA on the volume for the data set 


High-allocated RBA for the data set (not always the 
same as HARBA if the data set resides on several 
volumes) 


Key-sequenced data set’s high key value on a volume 
or, if the data set is divided into key ranges, the key 
range’s high key value 


RBA of the record containing the high key of a 
key-sequenced data set on a volume or, if the data set 
is divided into key ranges, the key range’s high key 
value 


Data set’s high-key and high-used RBAs 
Includes fields: HKRBA, HURBA 
High-used RBA on the volume for the data set 


High-used RBA for the data set (not always the same 
as HURBA if the data set resides on several volumes) 


Type of extent indicator 


Key-sequenced data set’s low-key value on a volume 
or, if the data set is divided into key ranges, in the 
key range 


Average logical record size 

Volume catalog record’s space map set of fields 
Length: 2 + L’BITMAP 

Includes fields: BITMAP, RELREPNO 
Control interval number 


Control interval number of index in twin association 
of upgrade set 
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Field Name Dictionary Entries (continued) 


Field 
Name 


NAMEDS 


NOBLKTRK 
NOBYTAU 
NOBYTTRK 
NODSDSP 
NODSET 
NODSEXT 
NODSPACE 
NODSPEXT 
NOEXTNT 
NONVOL 


NOTRKAU 
NOTRKEXT 
OPENCNT 
OPENC2 


OPENIND 
OPNCALL! 


OWNERID 
PASSATMP 


PASSPRMT 


PASSWALL 


PASSWORD 
PHYBLKSZ 
PRIMSPAC 
RELCRA 


RELIND 
RELREPNO 
REPNO 
RGATTR 
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53 


N N 


Location 


Combin 


Vol Info 
Vol Info 
Vol Info 
Special 
Special 
Special 
Header 


Vol-DSG 


Vol Info 


Combin 


Vol Info 
Special 
Header 


Combin 


Header 


Combin 


Header 


Password 


Password 


Combin 


Password 
Vol Info 
Header 


Combin 


Header 
Special 
Special 
Header 


Description 


Association set of fields 

Includes fields: NAME, TYPE 

Number of blocks per track 

Number of bytes per allocation unit 

Number of bytes per track 

Number of data sets in a data space (derived) 
Number of data sets on a volume (derived) 
Number of data set directory extents (derived) 
Number of data spaces on a volume (derived) 
Number of data space extents 

Number of volume information set of field’s extents 
NonVSAM data set’s volume information set of fields 


Includes fields: DEVTYP, DSCBTTR, FILESEQ, 
RELREPNO, VOLFLG, VOLSER 


Number of tracks per allocation unit 

Number of tracks in a data space’s extent (derived) 
Open count 

Catalog fields required by OPEN 


Includes fields: BUFSIZE, ENTNAME, EXCPEXIT, 
HURBADS, SPACOPTN 


Open indicator 
All header fields required by VSAM Open processing 


Includes fields: BUFSIZE, ENTNAME, HURBADS, 
SPACOPTN 


Owner identification number 


Number of attempts the operator has to supply the 
correct password 


Data set’s prompting name (codename) for security 
verification 


Password set of fields 
Length: 50 + LUSERAREC 


Includes fields: PASSATMP, PASSPRMT, 
PASSWORD, USERAREC, USVRMDUL 


All (4) 8-byte passwords 

Physical blocksize 

Primary space allocation amount 
Release indicator and CRA header fields 


Includes fields: CRADEVT, CRAIDNO, CRAVOL, 
RELIND 


Release indicator 
Relative repetition number 
Highest nondeleted sequence number 


Path/alternate index indicator 
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Field Name Dictionary Entries (continued) 


Field 
Name 


SCONSPAC 
SECFLAGS 
SLOCVOL 


SNSPHD 


SPACEHDR 


SPACEMAP 
SPACOPTN 
SPACPARM 


SPEXTENT 
SPHDFLG 
SYSEXTDS 


TOENTVOL 


TOVOLDEV 


TRBAEXT 
TRKSUSED 


TYPE 
TYPE2 


UPDVOL 


UPGRADE 


USERAREC 
USVRMDUL 


VOLDEV 


VOLDVCHR 
VOLEXT 


VOLFLG 


23 


64 


43 


20 


— —= Kh) W 


20 


1 


Location 


Header 
Header 
Combin 


Special 


Combin 


Special 
Header 
Combin 


Vol-DSG 
Vol-DSG 


Header 


Combin 


Combin 


Vol Info 
Special 
Assoc 
Assoc 


Combin 


Combin 


Password 
Password 


Combin 


Header 
Combin 


Vol Info 


Description 


Secondary space allocation amount requirement 
RACF security attributes 
Fields required by Superlocate 


Includes fields: DEVTYP, DSCBTTR, FILESEQ, 
ITYPEXT, RELREPNO, VOLFLG, VOLSER 


Data space sequence number for a data space 
(derived) 


Data space group set of fields 


Includes fields: DSCBPTR, DSCBTS, DSPSOPT, 
DSPSSQ, NODSDSP, NODSPEXT, RELREPNO, 
SPHDFLG 


Data space run length codes (derived) 
Space options 

Space allocation quantities and options 
Includes fields: PRIMSPAC, SPACOPTN, 
SCONSPAC 

Data space extent descriptors 

Data space flag (partially derived) 


Number of extents allowed per suballocation in the 
volume catalog record 


Track overflow entire volume 


Includes fields: DEVTYP, DSDIRSN, FILESEQ, 
HARBA, HKRBA, HURBA, ITYPEXT, 
NOBLKTRK, NOBYTTRK, NOEXTNT, 
NOTRKAU, PHYBLKSZ, RELREPNO, VOLFLG, 
VOLSER, LOKEYV, HIKEYV, EXTENT, 
NOBYTAU 


Track overflow volume and device characteristics 


Includes fields: DEVTYP, NOBLKTRK, 
NOBYTAU, NOBYTTRK, NOTRKAU, 
PHYBLKSZ 


Test RBA for EOV mount by RBA 
Tracks used in the data space (derived) 
Association entry type 


Entry type for second name of a twin association in 
the upgrade set 


Volume information set of fields for 
UPDATE-Extend processing 


Length: 43 + LHIKEYV + LLOKEYV 


Includes fields: DEVTYP, DSDIRSN, FILESEQ, 
HARBA, HIKEYV, HKRBA, HURBA, ITYPEXT, 
LOKEYV, NOBLKTRK, NOEXTNT, NOTRKAU, 
PHYBLKSZ, RELREPNO, VOLFLG, VOLSER 


Fields for a twin association in the upgrade set 
Includes fields: TYPE, NAME, TYPE2, NAME2 
Additional security verification data 


USVR (user security verification routine) module 
name 


Volume information set of fields required by VSAM 
Open processing 


Includes fields: DEVTYP, NOBLKTRK, 
NOTRKAU, PHYBLKSZ 


Device characteristics—in the volume catalog record 
Volume information set of fields 
Length: 10 + LEXTENT 


Includes fields: DSDIRSN, EXTENT, RELREPNO, 
VOLSER 


Volume information flags 
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Field Name Dictionary Entries (continued) 


Field 

Name Len Location Description 

VOLPHY — Combin Volume information set of fields required by VSAM 
Open processing 
Length: 23 + LEXTENT + L’HIKEYV + 
L’LOKEYV 
Includes fields: EXTENT, HARBA, HIKEYV, 
HKRBA, HURBA, ITYPEXT, LOKEYV, 
NOEXTNT, RELREPNO, VOLFLG, VOLSER 

VOLRFLG 1 Header Volume catalog record flags 

VOLSER 6 Vol Info Volume serial number 

VOLTSTMP 8 Header Volume catalog record timestamp 


Dictionary Example 1 


The DSETCRDT (data set creation date) field is written as a parameter string 
of the macro, as follows: 


DSETCRDT,0,101,3,0 


It appears in the dictionary as X‘C4E2C3D900650300’. The first X‘00’ 
(B‘0000 0000’) is the fourth byte value of the field-name dictionary entry; it 
indicates that DSETCRDT is (a) a fixed-length field, (b) not part of a set of 
fields, and (c) not a flag field. 


The X‘65’ is the fifth-byte value of the field-name dictionary entry; it 
indicates that DSETCRDT is at displacement X‘65’ from the beginning of the 
record in which it appears. 


The 3 is the sixth-byte value of the entry; it indicates that DSETCRDT is 
three bytes long. 


The 0 is the seventh-byte value of the entry; it is zero because DSETCRDT is 
not part of a set of fields and, therefore, is not associated with a set of fields 
type (group) code. 
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Dictionary Example 2 


The DSPSOPT (data-space-creation space options) field is written as a 
parameter string of the macro as follows: 


DSPSOPT,80,19,1,6 


It appears in the dictionary as X‘C4E2D6D750110106’. The X‘50’ (B‘0101 
0000’) is the fourth-byte value of the field-name dictionary entry; it indicates, 
when converted to binary, that DSPSOPT is (a) a fixed-length field that is 


part of a set of fields, (b) a flag field, and (c) not a fixed-length field within a 
variable-length field. 


The X‘13’ is the fifth-byte value of the field-name dictionary entry; it 
indicates that DSPSOPT is at displacement X’13’ from the beginning of the 
set of fields to which it belongs. 


The 1 is the sixth-byte value of the entry; it indicates that DSPSOPT is 1 byte 
long. 


The 6 is the seventh-byte value of the entry; it indicates that DSPSOPT is 
part of a set of fields associated with a type (group) code of 6, which means 
that it is part of a set of fields that contains VSAM data space information. 


Control Block Interrelationships 


Figure 42, Open Catalog Control Blocks, shows the OS/VS2 system and 
catalog management control blocks that describe an OS/VS2 catalog to the 
OS/VS2 system. 


Figure 43, VSAM Control Blocks That Describe a Catalog (A 
Key-Sequenced Key-Range VSAM Data Set), shows the VSAM control 
blocks that describe the OS/VS2 catalog as a VSAM data set. This control 
block structure allows VSAM Record Management to read and write control 
intervals in the OS/VS2 catalog, and to update the catalog’s index, as 
required when OS/VS2 catalog management I/O functions issue GET, PUT, 
and ERASE macro instructions. See OS/VS2 VSAM Logic for VSAM 
Record Management details. 
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Figure 42. Open Catalog Control Blocks 
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Figure 43. VSAM Control Blocks That Describe a Catalog (Key-Sequenced Key-Range VSAM Data Set) 
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Figure 44 shows the OS/VS2 catalog management control blocks built when 
OS/VS2 catalog management is called to process a catalog record. 
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Figure 44. Catalog Management Control Blocks 
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Catalog Management Control Block Descriptions 


S ACB—Access Method Control Block 


The VSAM ACB describes a VSAM cluster or OS/VS2 catalog. After the 
OS/VS2 catalog is opened, its ACB is pointed to by a CAXWA (CAXACB). 
The master catalog’s ACB 1s pointed to by the AMCBS (CBSACB) and by 
the last CAXWA in the CAXWA chain. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) | ACBID Control block identifier, X‘AO’ 
1 (1) | ACBSTYP Subtype 
2 (2) 2 ACBLENG Length of the ACB 
4 (4) ACBAMBL Address of the AMBL 
ACBJIWA Address of the JES work area 
ACBIBCT Address of the IBCT 
8 (8) ACBINRTN Address of the VSAM Interface routine 
(IDA019R1) 
12 (C) ACBMACRF MACRF flags 
ACBMACRI MACRF flag byte 1: 
ACBKEY The record is identified by a key—keyed 
processing 
ACBADR The record is identified by a RBA 
ACBADD (relative byte address)—addressed processing 
..1..... ACBCNVControl interval processing 
ACBBLK 
ACBSEQ Sequential processing 
ACBDIR Direct processing 
ACBIN Input (GET, READ) processing 
ACBOUT Output (PUT, WRITE) processing 
ACBUBF User-supplied buffer space 
13 (D) ACBMACR2 MACRF flag byte 2: 
Reserved 
ACBSKP Skip sequential processing 
ACBLOGON VTAM LOGON indicator 
ACBRST Set data set to empty state 
ACBDSN Basic subtask shared control block 
connection on common DSNAMEs 
ACBAIX Entity to be processed is the alternate index 
of the path specified in the given DDNAME 
14 (E) ACBBSTNO Number of concurrent strings for alternate 
index path 
15 (F) ACBSTRNO Number of RPL strings 
16 (10) ACBBUFND Number of buffers requested for data 
18 (12) ACBBUFNI Number of buffers requested for index 
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Access Method Control Block (ACB) Description and Format (continued) 


Bytes and 
Offset Bit Pattern 
20 (14) 4 
1 
en 
oh Fe 
1... 
whe 
..0. 
na 
.X 
1 
22 (16) 2 
24 (18) 1 
.XXX XXXX 
25 (19) 1 
HX a5 
XXXX 
26 (1A) 2 
| ee 
fle 
wake 
XX .X.X 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
Before OPEN 
40 (28) 8 
After OPEN 
40 (28) 2 
42 (2A) 1 
43 (2B) 1 
44 (2C) 1 
45 (2D) 3 
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Field Name 


ACBBUFPL 
ACBMACR3 


ACBLSR 
ACBGSR 
ACBICI 
ACBDFR 
ACBSIS 
ACBNCFX 


ACBMACR4 
ACBJBUF 

ACBRECFM 
ACBRECAF 


ACBCCTYP 


ACBASA 


ACBOPT 
ACBDSORG 
ACBCROPS 


ACBCRNCK 


ACBCRNRE 


ACBDORGA 
ACBSDS 


ACBMSGAR 
ACBPASSW 


ACBEXLST 
ACBUEL 


ACBDDNM 


ACBTIOT 
ACBINFL 
ACBAMETH 
ACBERFE 
ACBDEB 


Description 
Address of the buffer header (BUFC) 
MACRF flag byte 3: 


Reserved 

Local shared resources 

Global shared resources 

Improved control interval processing 
Write operations are to be deferred 
Sequential insert strategy 

Control blocks are not fixed 

Control blocks are fixed 

Reserved 


Reserved 
Number of buffers requested for journal 
Record format: 


JES format 
Reserved 


Control character: 


Reserved 
Control character type 


Non-user options 
Match ACBDORGA with DCBDSORG 
Checkpoint/restart options: 


Restart has not checked for modifications 
since last checkpoint 
Data added since last checkpoint has not 


been erased by restart, and no reposition to 


last checkpoint takes place 
ACB indicator 


The ACB describes a data set that can be 
accessed by more than one address space’s 
programs. 

Reserved 


Message area 
Address of the user-supplied password 


Address of the user exit list (EXLST) 
Alternate name for ACBEXLST 


DD name 


Offset to the TIOT 
Indicator flags 
Access method type 
Error flags 

Address of the DEB 


J 
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Access Method Control Block (ACB) Description and Format (continued) 


Bytes and 
Offset Bit Pattern Field Name Description 
Not Changed by OPEN 
48 (30) 1 ACBOFLGS Open/Close flags: 
A. ACBEOV EOV concatenation 
Bake ACBOPEN The ACB is open 
Leas ACBDSERR No further requests are possible against the 
ACB 
ACBEXFG An ACB Exit routine exists 
dae ACBIOSFG The Open or Close routine is in control 
XX... .X.. Reserved 
49 (31) I ACBERFLG Error flags 
Note: See “Diagnostic Aids: Error Codes”’ in 
OS/VS2 VSAM Logic for details on the 
ACBERFLG error flags. 
50 (32) 2 ACBINFLG Indicator flags: 
alas ACBJEPS JEPS processing 
ro ACBIJRQE RQE being held by JAM 
aint ACBCAT The ACB describes a VSAM catalog 
lists ACBSCRA Catalog control blocks are built in system 
storage 
ls ACBUCRA Catalog control blocks are built in user 
storage 
ACBVVIC Data set being opened can be accessed by 
more than one address space’s programs 
aoe ACBBYPSS Bypass security on OPEN if user authorized. 
X.. Reserved 
51 (33) | Reserved 
52 (34) 4 ACBUJFCB Address of the user JFCB 
56 (38) 4 ACBBUFSP Amount of space available for the buffers 
60 (3C) 2 ACBBLKSZ Length of the physical DASD record 
ACBMSGLN Message area length 
62 (3E) 2 ACBLRECL Length of the user's record 
64 (40) 4 ACBUAPTR Address of the user’s work area 
68 (44) 4 ACBCBMWA Address of the CBM work area 
72 (48) 4 ACBAPID Address of application ID 
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AMCBS—Access Method Control Block Structure Block 


The AMCBS contains information that is used by OS/VS to locate the master 
catalog and user catalogs. The AMCBS is built when the master catalog is 
opened, during NIP (nucleus initialization processing). The CVT 

(CVTCBSP) points to the AMCBS. 


Offset 
0 (0) 
2 (2) 
4 (4) 
8 (8) 


12 (C) 


16 (10) 


20 (14) 
24 (18) 
28 (1C) 
32 (20) 


Bytes and 
Bit Pattern Field Name Description 
2 CBSID AMCBS ID character 
2 CBSSIZ Length of the AMCBS 
4 CBSMCSTA Location (CCHH) of the master catalog 
4 CBSACB Address of the OS/VS2 master catalog’s 
ACB 
4 CBSCBP Address of the control block manipulation 
routine (IDA019C1) 
4 CBSCMP Address of the catalog management 
high-level routine (IGGOCLA1) 
CBSMCUCB Address of the master catalog’s UCB 
(contains this information until the master 
catalog is opened) 
CBSCAXCN Address of the CAXWA chain 
CBSCRACA Address of the CRA CAXWA chain 
4 CBSCRTCB Address of CRA task TCB 
64 CBSVSRT CDS (compare and swap double) word for 


VSRT (VSAM shared resource table) 


| The following pair of fields is repeated eight times—once for each of the keys O through 7: 
4 


CBSVUSE VSRT use count 
4 CBSVPTR Address of the VSRT 


AMDSB—Access Method Data Statistics Block 


The AMDSB contains statistical information about record processing in the 
data set. It also contains some of the data set’s attributes and specifications. 
The AMDSB is built, using thedata set or index catalog record’s AMDSB set 
of fields, when the cluster is opened. A copy of the AMDSB is contained in 
the data set’s Data catalog record and, if the data set is key-sequenced, in the 
Index catalog record. The data or index AMB (AMBDSB) points to its 
associated AMDSB. 
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Access Method Data Statistics Block (AMDSB)—Description and Format 


(continued) 
Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
| eae 
Oiives 
i eee 
oP ae 
ee og 
so lie 
ee lee 
“el. 
Bite ta 1 
2 (2) 2 
4 (4) 2 
6 (6) 2 
8 (8) 2 
10 (A) 1 
11 (B) 1 
12 (C) Z 
14 (E) 2 
16 (10) 4 
20 (14) 4 
24 (18) 4 
28 (1C) 4 
32 (20) 4 
36 (24) 4 


Field Name 


AMDSBID 


AMDATTR 


AMDDST 


AMDWCK 
AMDSDT 


AMDREPL 


AMDORDER 


AMDRANGE 


AMDRRDS 
AMDSPAN 


AMDLEN 


AMDNEST 
AMDAKRKP 
AMDRKP 
AMDKEYLN 


AMDPCTCA 


AMDPCTCI 


AMDCIPCA 


AMDFSCA 


AMDFSCI 
AMDCINV 
AMDLRECL 


AMDHLRBA 


AMDNSLOT 


AMDSSRBA 


AMDMAXRR 


AMDPARDB 


Description 
AMDSSB identifier, X‘60 
Attributes of the data set: 


Key-sequenced data set 

Entry-sequenced data set 

Check each record when it is written 
Sequence set is stored with the data and is 
replicated—duplicated as many times as 
possible around the track 

All index records are replicated—duplicated 
as many times as possible around the track 
Use the volumes in the same order as in the 
volume list 

The data set is divided into key ranges 
Relative record data set 

Data set contains spanned records 


Length of the AMDSB 


Number of index entries in the index section 
Relative key position of the alternate key. 
Relative key position 

Key length 


Percentage of free control intervals in the 
control area 


Percentage of free bytes in the control 
interval 


Number of control intervals in a control area 


Number of free control intervals in a control 
area 


Number of free bytes in a control interval 
Control interval size 
Maximum record size 


Relative byte address (RBA) of the high-level 
index record (KSDS) 

Number of record slots per control interval 
(RRDS) 


Relative byte address (RBA) of the first 
sequence-set record (KSDS) 

Maximum valid relative record number 
(RRDS) 


Address of the first ARDB 
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Access Method Data Statistics Block (AMDSB)—Description and Format 
(continued) ) 
Bytes and 
Offset Bit Pattern Field Name Description 
40 (28) | AMDATTR3 Attributes: 
| ee AMDUNQ The data set has nonunique keys. 
Ouse ses: The data set has unique keys. 
i: eee AMDFAULT The data set is staged by cylinder fault 
.O.. 2... The data set is staged at open time, if 
required ¥ 
wel cates AMDBIND The data set is staged and bound 
Osis The data set is not bound 
sal ates AMDWAIT Destaging is completed before control is » 
returned to the program that closes the data 
set 
ae 0 em There is no waiting to return control 
52 dhiees AMDLM The data set is loaded. 
wae OL... The data set is in load mode or is not loaded. 
veces «XXX Reserved 
41 (29) 7 Reserved 
48 (30) 48 AMDSTAT Data set statistics: 
48 (30) 8 AMDSTSP OS/VS system time stamp 
56 (38) 2 AMDNIL Number of index levels 
58 (3A) 2. AMDNEXT Number of extents in the data set 
60 (3C) 4 AMDNLR Number of user-supplied records in the data J 
set 
64 (40) 4 AMDDELR Number of deleted records 
68 (44) 4 AMDIREC Number of inserted records 
72 (48) 4 AMDUPR Number of updated records 
76 (4C) 4 AMDRETR Number of retrieved records 
80 (50) 4 AMDASPA Number of bytes of free space in the data set 
84 (54) 4 AMDNCIS Number of times a control interval was split 
88 (58) 4 AMDNCAS Number of times a control area was split 
92 (SC) 4 AMDEXCP Number of times EXCP was issued by VSAM ’ 
1/O routines 
CAXWA—Catalog Auxiliary Work Area 


The CAXWA is built when an OS/VS2 master or user catalog is opened or is 
being created. The CAXWA is used to contain the addresses of control 
blocks and work areas needed when a catalog such as the alternate TIOT, the 
| DRWA, and the UCB is being opened or created. The CAXWA also contains 
flags that indicate the type of processing being performed on the catalog and 
the OS/VS component that invoked the processing. Each CAXWA points to 
a catalog’s ACB. The ACB describes the catalog as a key-sequenced VSAM 
data set. All CAXWAs that describe the catalogs available to a user’s - 
program are chained together. The AMCBS (CBSCAXCN) contains the 
address of the CAXWA chain. 
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Catalog Auxiliary Work Area (CAXWA)—Description and Format (continued) 


Offset 
0 (0) 


1(1) 
4 (4) 


8 (8) 


9 (9) 


10 (A) 


11 (B) 

12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
32 (20) 


Bytes and 
Bit Pattern 


l 


Field Name 
CAXID 


CAXCHN 
CAXFLGS 


CAXBLD 
CAXOPN 
CAXCLS 

CAXEOV 
CAXCMP 
CAXMCT 


CAXCMR 


CAXSCR 


CAXFLG2 
CAXF2DT 


CAXF2NDD 
CAXF2NCR 


CAXF2IOE 
CAXF2CLR 
CAXF2CA 
CAXF2REC 
CAXF2VTU 


CAXFLG3 


CAXF3AT 
CAXF3ANE 
CAXF3B5 


CAXF3B6 


CAXRAC 


CAXACT 
CAXATIOT 
CAXSCHWA 
CAXDRWP 
CAXACB 
CAXUCB 
CAXCCR 
CAXHACI 


Description 


Control block identifier, X‘CA’ 


Reserved 
Address of the next CAXWA in the chain 
Flags: 


Build request 

The catalog is being opened 

The catalog is being closed 

An End of Volume routine is in control 
Open/Close/EOV processing is complete 
Identifies the OS/VS2 master catalog 
Identifies an OS/VS2 user catalog 
Catalog management has been called by 
another catalog management routine 
Catalog Management (SVC 26) has been 
called by the OS/VS Scheduler 

Catalog management (SVC 26) has been 
called by an Access Method Services 


._procedure 


Flags: 

The catalog has been deleted. The following 
flags are set by IFGO191X and IFGO200N: 
No DDNAME found 

Unable to obtain virtual storage with a 
GETMAIN request 

I/O error 

RPL cleanup request 

If an error occurs, free the CAXWA 
Recoverable catalog 

Volume time stamp updated 


Flags: 


CRA alternate TIOT exists 

CRA does not exist 

Password not read 

No passwords 

Master password; no update password 
Master and update passwords 

Catalog is RACF-defined 

Reserved 


Catalog activity count 

Address of the alternate TIOT 
Address of the Scheduler work area 
Address of the catalog’s DRWA 
Address of the catalog’s ACB 
Address of the UCB 

Catalog control record information 


Control interval number of the highest 
allocated contro] interval in the catalog 
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Catalog Auxiliary Work Area (CAXWA)—Description and Format (continued) 


Offset 
35 (23) 


38 (26) 
41 (29) 


44 (2C) 
46 (2E) 


48 (30) 


52 (34) 
52 (34) 
58 (3A) 
62 (3D) 
66 (42) 
74 (4A) 
96 (60) 
96 (60) 


97 (61) 

100 (64) 
104 (68) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 


130 (82) 


-XXX 


CCA—Catalog Communications Area 


Bytes and 
Bit Pattern 


3 


Field Name 
CAXNFCI 


CAXCDCI 
CAXFDCI 


CAXRPLCT 


CAXRPL 


CAXCNAM 
CAXVOLID 
CAXRACTS 
CAXRATEP 
CAXRADDN 


CAXOPLST 
COPTS 
CENLST 


COPACB 
CAXOPEWA 
CAXCCA 
CAXPLOCK 
CAXJIDE 
CAXCRACB 
CAXRACP 
CAXECB 
CAXASCBP 
CAXHRPLC 


CAXWNQID 


Description 


Control interval number of the next free 
control interval in the catalog 


Number of deleted control intervals 


Control interval number of the first deleted 
control interval in the catalog 


Reserved 


Number of RPLs associated with the 
CAXWA 


Address of the first RPL in the CAXWA’s 
RPL chain 


Catalog’s DSNAME 

CRA volume serial 

CRA creation time stamp 
CRA’s TIOT entry address 
CRA’s DDNAME 
Reserved for CRA 
Open/Close parameter list: 
Option flags: 


End of list indicator 
Reserved 


Address of the catalog’s ACB 

Address of the Open/Close/EOV work area 
Address of the CCA 

Cross-memory POST lock 

Address of the JDE 

Address of the CRA’s ACB 

Address of RACF profile 

RPL WAIT ECB 

Address of waiting memory’s ASCB 


Hung-up RPL count. A hung-up RPL ts one 
that was not freed because an ABEND 
occurred while I/O was in process. 


RPL WAIT ENQ count 


The CCA is built each time an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process an OS/VS2 master or user catalog record. 
The CCA contains information about the catalog being processed, and about 
the catalog record and its extensions contained in each of the six buffers 
(RABs) available to process the user’s request. The CCA is used to pass 
information between catalog management procedures. Register 11 contains 
the address of the CCA currently being processed. The CAXWA 
(CAXCCA) points to the CCA that describes the request currently 
processing its catalog’s records. 
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Bytes and 
( Offset Bit Pattern Field Name Description 
: 0 (0) 2 CCAID CCA ID=‘ACCA’ 
2 (2) 2 CCASZ Size of CCA 
4 (4) 4 CCAPROB Problem determination 
2 CCAMODID Error module ID 
6 (6) 2 CCAERRCD Error codes (DSECT for next two bytes) 
1 CCAREASN Set reason code 
. CCACDR Refer reason code 
1 CCARETRN Set return code 
CCACD1 Refer return code 
8 (8) 5 Reserved 
13 (D) 1 CCACD2 Return code 2 


Note: See “Diagnostic Aids: Error Codes’”’ 
for a list of the VSAM Catalog Management 
return codes and error codes. 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and 
Offset Bit Pattern 


14 (E) 
Viens 
alge 
viells 
eel 
15 (F) 
Iie, 
re 
..0. 
a 
shel 
sac) 
16 (10) 


Field Name 


CCAFLG!1 


CCAFILPS 
CCAFICNS 


CCAFILRD 
CCAFIKEY 


CCAFIKGE 
CCAFICR 
CCAF1UP 
CCAFIDK 


CCAFLG2 
CCAF2SYS 
CCAF2NVC 


CCAF2CCT 


CCAF2XEQ 


CCAF2RHS 


CCAF2COB 
CCAF2CO 
CCAF2CB 
CCAF2SMO 


CCAFLG3. 


CCAEXGRI1 
CCAGC4 


CCAGDSP 


CCAEXGR2 
CCANF 
CCAELC2 
CCALFT 
CCAEGREC 


Description 
Flags Byte 1: 


Stop the loop 

Master catalog is being searched for a user 
catalog catalog record 

CCR read into core 

Retrieve the catalog record based ona 
DSNAME value 

Retrieve the next catalog record 

A checkpoint of the CCR is required 

GET for update 

When the caller is renaming a data set, this 
flag indicates that the data set’s true-name 
record is to be deleted, but the data set’s 
catalog record is not to be deleted. 


Flags Byte 2: 


The caller is an OS/VS system module 

No validity check on the caller’s CTGFL or 
work area is required 

Search all catalogs available to the caller. 
Search the first OS/VS2 catalog specified by 
the caller’s STEPCAT statement. If the 
caller’s JCL doesn’t include a STEPCAT 
statement, search the OS/VS2 master 
catalog. In either case search only one 
catalog. 

Exclusive enqueue 

Shared enqueue 

When a catalog management routine calls 
the VSAM Open routines to open a newly 
created catalog, and the Open routines call 
OS/VS2 Catalog Management routines to 
obtain information about the catalog to be 
opened, the situation is called a “recursive 
call’’. The catalog cannot be dequeued when 
the Catalog Management routines return to 
the caller (VSAM Open routines). 

Both catalog open and build: 

Catalog is being opened 

Catalog is being created 

Search the master catalog only 


Flags Byte 3: 


Exit indicator 

The catalog record contains a password 
information set of fields (identified by type 
(group) code 4) (detected during IGGPSCNC 
processing) 

Caller specified the GENDSP option 
(detected during IGGPSCNC processing) 
Exit indicator 

The set of fields cannot be found 

Exit indicator 

First time 

Exit indicator 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 
17 (11) 


18 (12) 


19 (13) 


20 (14) 
20 (14) 
24 (18) 
24 (18) 


28 (1C) 


32 (20) 
36 (24) 
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Bytes and 
Bit Pattern 


1 


1 


1 


ha f£ ff FBR fh HLH FA 


Field Name 
CCAFLG4 
CCAF4DRQ 


CCAF4BYS 
CCAGVNC 


CCAGVNF 


CCAGVNBS 


CCAGVEX 
CCAGVNE 


CCATCOMP 


CCAFLG5 


CCAMEX2 
CCAMEX 
CCAMEX1 
CCAMODPA 


CCATHIT 


CCATEX 
CCATEX1 
CCATEX2 


CCAFLG6 
CCAMCODR 


CCADELP 
CCAMNOSP 


CCAINIT 
CCASUPFD 


CCAREUSE 


CCAEXT 


CCAMOD 


CCATCB 
CCALBCYL 
CCARB 
CCADPL 
CCACPL 
CCAACB 
CCANPCCB 


Description 
Flags Byte 4: 


The catalog must be dequeued after the 
request completes 

Bypass the security verification 

The required variable-length field is not 
completely contained in the record currently 
in the buffer 

The set of fields identified by the 
caller-specified sequence number cannot be 
found 

There is no buffer space available to contain 
an extension record 

Exit indicator 

The field does not exist in the located set of 
fields 

Test complete: all set-of-fields pointers have 
been examined and all designated fields have 
been tested 


Flags Byte 5: 


Exit indicator 

Exit indicator 

Exit indicator 

The catalog record’s base record must be 
written (using IGGPPAD) into the catalog 
Successful test: a set of fields has been found 
that satisfies the test conditions 

Exit indicator 

Exit indicator 

Exit indicator 


Flags Byte 6: 


The catalog must be dequeued when the 
request completes 

A deleted set-of-fields pointer was found 
The catalog record’s free space isn’t large 
enough to contain all the new catalog 
information during the set of fields move 
operation 

Insert switch for variable-length field being 
retrieved 

Suppress password field information during 
field retrieval 

The contents of the caller’s record areas 
(buffers) can be used by IGGPEXT and 
IGGPMOD 

Set when a catalog management routine calls 
the Extract routine (IGGPEXT) 

Set when a catalog management routine calls 
the Modify routine (IGGPMOD) 


Address of the TCB 

Address of the label cylinder data 
Address of the RB 

Address of the DADSM parameter list 
Address of the caller’s CTGPL 
Address of the catalog’s ACB 

Address of the next PCCB 


Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 
40 (28) 


44 (2C) 


44 (2C) 


47 (2F) 
88 (58) 


88 (58) 


89 (59) 
90 (SA) 
92 (SC) 
96 (60) 
96 (60) 


100 (64) 
104 (68) 


108 (6C) 


128 (80) 


148 (94) 


168 (A8) 


188 (BC) 


Bytes and 
Bit Pattern 


4 


44 


4) 
20 


Field Name 
CCAURAB 


CCASRCH 


CCASRID 
CCASRCIN 


CCARABO 


CCARXxFLG 


CCARxUR 


CCARxU1 


CCARxU2 
CCARxWR 


CCARxPA 


CCARxUPD 


CCARxRPL 


CCARxREC 
CCARxSEG 
CCACPE2x 


CCACPE3x 
CCACPE4x 


CCARAB!1 


CCARAB2 


CCARAB3 


CCARAB4 


CCARABS5 


Description 


Address of the record area block (RAB) 
currently in use 


Search argument (DSNAME of a cluster, 
data set, index, catalog, alias, generation 
data group, or nonVSAM data set, ora 
volume serial number) 


Control interval number 


Remainder of CCASRCH 


Record Area Block 0: Each record area block 
describes the catalog record contained in one 
of the six catalog management buffers 
available for the request. RABs | through 5 
are identical in format to RAB 0. 


Note: ‘x’ in each field name is replaced by ‘0’ 
through ‘5’ to indicate a particular RAB’s 
field. 


Flags: 


The following flag is used by IGGPEXT and 
IGGPMOD: 

The RAB is in use. It cannot be used by 
IGGPEXT or IGGPMOD 

The RAB is temporarily in use by IGGPEXT 
or IGGPMOD. It cannot be overlaid. 

(Same as CCARxU!) 

The buffer must be written before another 
catalog record can be read into it 

The buffer contains a new catalog 
record—PUT-ADD is required to add the 
record to the catalog 

Reserved 

The buffer contains a GET-for-update record 


Number of the last assigned RPL in the RPL index 
Reserved 

Address of the record in the buffer 

Addresses of parts of the catalog record: 


Address of the first byte after the fixed-length 
header fields. 


Address of the first set of fields 


Address of the first free-space byte in the 
record 


Record Area Block 1 (See RAB 0 
description) 


Record Area Block 2 (See RAB 0 
description) 


Record Area Block 3 (See RAB 0 
description) 


Record Area Block 4 (See RAB 0 
description) 


Record Area Block 5 (See RAB 0 
description) 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and 

Offset Bit Pattern Field Name Description 

208 (DO) 1 CCARPLK Work area for IGGOCLAG and IGGOCLAM 

209 (D1) 1 CCARPLF Work area for IGGOCLAG and IGGOCLAM 

210 (D2) 1 CCARPLX Work area for IGGOCLAG and IGGOCLAM 

211 (D3) 1 CCARPLT Work area for IGGOCLAG and IGGOCLAM 

212 (D4) 6 Reserved 

218 (DA) 1 CCASC Code to indicate the type of search being 
performed 

219 (DB) 1 CCAQLEN Length of the Ist-level qualifier name (0 if 
the data set’s dsname is not qualified). 

220 (DC) 4 CCARPLI Address of the RPL in use 

224 (EO) 44 CCADESA Save area for the extent information returned 
by OS/VS DADSM and OS/VS2 Catalog 
Management: Suballocate 

224 (EO) 1 CCANDEXT Number of extents 

225 (El) 1 CCAIXEXT Extent index value 

226 (E2) 2 CCASSVOL Sequence number of the data set directory 
entry in the volume catalog record 

228 (E4) 40 CCAEXTDE Five 8-byte extent descriptors: 

2 CCAEXTSS Sequence number of the Data Space Group 
set of fields that this extent’s space is a part 
of. 

4 CCAEXTAD The extent’s starting physical address: 

2 CCAEXTCC Cylinder number CC 

2 CCAEXTHH Head number HH 

2 CCAEXTTH Number of tracks in the extent 

268 (10C) 1 CCAASCIK Number of control intervals required to 
satisfy the caller’s request 
269 (10D) 1 CCACRRP RPL used to read CCR 
270 (10E) 1 CCAASCIX Used by the ASSIGN functions—points to 
the element in CCAASCI currently being 
processed 
271 (10F) 9 CCAASCI Number of each assigned control interval 
280 (118) 16 CCAEQDQ ENQ/DEQ parameter list 
280 (118) 1 CCAEDXFF ‘End of parameter list” indicator—X‘FF’ 
281 (119) 1 CCAEDRLN Length of minor name 
282 (11A) 1 CCAEDOPT ENQ/DEQ options 
1... CCAEDSHR Shared 
Ozeie seas Exclusive 
.XXX XXXX Reserved 
283 (11B) 1 CCAEDRCD ENQ/DEQ return code 
284 (11C) 4 CCAEDQNM Address of the major name 
288 (120) 4 CCAEDRNM Address of the minor name 
292 (124) 4 CCAEDUCB Address of the UCB 
296 (128) 4 CCAMLRET Address of the caller’s save area 
300 (12C) 12 CCAMSSPL Storage management work area 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 

300 (12C) 
304 (130) 
308 (134) 
309 (135) 
310 (136) 
312 (138) 
316 (13C) 
316 (13C) 


320 (140) 


Bytes and 
Bit Pattern 


4 


4 


Field Name 
CCAMNLLP 
CCAMNPTR 


CCAMNSPL 


CCARPRM 
CCACMS 
CCACMSWA 


CCAEXCMS 


Description 


Number of bytes to process 

Address of the return address 

Storage management byte 

Required subpool number 

Storage management byte 

Return parameters 

Catalog Management Services work area 


Address of the Catalog Management Services 
calling routine’s work area 


Address of a secondary Catalog Management 
Services work area 


The following fields are set and used by IGGPLOC, IGGPEXT, IGGPMOD, and IGGPTSTS, 
and catalog management subfunctions that these procedures call: 


324 (144) 
324 (144) 
328 (148) 


332 (14C) 


336 (150) 


340 (154) 
344 (158) 


348 (15C) 


352 (160) 
356 (164) 
358 (166) 
360 (168) 
364 (16C) 


368 (170) 
372 (174) 


376 (178) 


380 (17C) 


384 (180) 


b ff NY NY F 


> 


CCALUME 
CCACPE5 
CCACPES1 


CCACPE52 


CCACPES3 


CCACPE6 


CCACPE61 
CCARABSE 


CCACPE7 
CCAIDPT 


CCACPE71 
CCAGOPLN 
CCASL 
CCAILNG 


CCAFLPT 
CCATFLPT 


CCARABPT 
CCADICT 


CCAXCPL 


CCAMCPL 


CCARABB 


CCARABF 


Field management work area: 
Address of a selected set-of-fields pointer 


Address of a second selected set-of-fields 
pointer 


Address of a third selected set-of-fields 
pointer 


Address of a fourth selected set-of-fields 
pointer 


Address of a selected set of fields 


Address of a second selected set of 
fields 


Address of field value 


Address of a second selected retrieved field 
Length of the set-of-fields pointer 

Number of bytes for the sequence number 
Length of the selected retrieved field 


Address of the requested-field CTGFL 
Address of the CTGFL-for-tests 


Address of the record area block 


Dictionary information to describe the field, 
based on its field name 


Address of the CTGPL built when 
IGGPEXT 

and IGGPMOD are called, so that 
information in the caller’s CTGPL is not 
altered 


Address of the RAB that identifies the base 
catalog record 


Address of the RAB that identifies the first 
record area (buffer) that can be used by 
IGGPEXT or IGGPMOD 


Data Areas 353 


Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and 

Offset Bit Pattern Field Name Description 

388 (184) 4 CCARABL Address of the RAB that identifies the last 
record area (buffer) that can be used by 
IGGPEXT or IGGPMOD 

392 (188) 3 CCACBASE The control interval number of the base 
catalog record 

395 (18B) 1 CCAGC Group code of the requested set of fields 

396 (18C) 2 CCALREL Relative repetition number of a selected 

CCALREL!I set of fields 
398 (18E) 2 CCASN Sequence number of a selected set of fields 
CCASNI1 

400 (190) 2 Reserved 

402 (192) 2 CCAITXFPL Index to the current CTGFL being processed 

404 (194) 2 CCAIXREL Index for CCATREL 

406 (196) 2 CCATNREL The sequence number of the next set of fields 
to perform tests against if CCATREL is full 
or if there are no buffers available to contain 
the catalog record’s next extension 

408 (198) 2 CCATNUM Number of successful relative repetition 
numbers (cannot exceed 16) 

410 (19A) 32 CCATREL Successful relative repetition numbers 

442 (1BA) 2 CCATNO Total number of successful relative repetition 
numbers (might exceed 16) 

444 (1BC) 4 CCATEST Address of the test CTGFL 

448 (1C0) 20 CCARBA Work area for extent descriptors 

448 (1CO) 6 CCACRAVL CRA’s volume serial 

448 (1C0) 2 CCASS Sequence number of the Data Space Group 
set of fields that contains the extent 

450 (1C2) 4 CCACCHHI1 Physical address—CCHH—of the extent’s 
first track 

454 (1C6) 4 CCACCHH2 Physical address—CCHH—of the extent’s 
last track 

454 (1C6) 4 CCACRADT CRA device type 

458 (1CA) 2 CCATT Number of tracks in the extent 

460 (1CC) 4 CCARBAI Low relative byte address (RBA) 

464 (1C0) 4 CCARBA2 High relative byte address (RBA) 

468 (1D4) 2 CCATLNG The total length of the extent information 

CCATLEN that has been processed 

470 (1D6) 2 CCARBAL RBA extent balance 

472 (1D8) CCACNIX Combination name index 

474 (1DA) CCASMFIX The type of SMF record to be written when a 
cluster or catalog is defined (SMF record for 
the cluster, data set, or index) 

476 (1DC) 4 CCAIDPT2 Address of the available space in the caller’s 
work area or of the caller-supplied update 
information 

480 (1E0) 4 CCAIDPT3 Address of the length-field of a 

CCARABSM variable-length field in the user's RAB 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 
484 (1E4) 


486 (1E6) 


488 (1E8) 


491 (1EB) 


492 (1EC) 


493 (IED) 


494 (1EE) 


496 (1F0) 


498 (1F2) 


500 (1F4) 


502 (1F6) 


504 (1F8) 


506 (1FA) 


509 (1FD) 
512 (200) 
516 (204) 
520 (208) 
522 (20A) 
524 (20C) 
528 (210) 


532 (214) 
536 (218) 
540 (21C) 
544 (220) 
548 (224) 


Bytes and 
Bit Pattern 


2 


& FN NY Ff FS W 


Field Name 
CCAGVCT 


CCANEVV 


CCAGVEXT 


CCANEFV 


CCAGRGC 


CCARCDID 


CCAGRHI 
CCAGRHI1 
CCASSEQ 


CCAIXTPL 
CCADLEN 


CCADIFF 


CCAREPCT 


CCADISP 


CCASVCI 


CCASVCI1 
CCADTA 
CCACDTA 
CCADTCT 
CCACDTCT 
CCACWAP 
CCASDWAP 


CCAILNG3 
CCAILNG2 
CCAALPTR 
CCASMFPT 
CCALCPL 


Description 


Number of set-of-fields pointers processed so 
far 


If the requested variable-length field is 
non-existant, this field is set to binary zero 


Control interval number of the record’s next 
extension record (not yet in a buffer) 


If the requested fixed-length field is non- 
existant, this byte is set to X‘FF’ 


Reserved 


Type (group) code of the requested set of 
fields 
Record ID 


High sequence number of the requested 
set of fields 
Sequence number 


Index to test CTGPLs 


Number of bytes to be deleted from the 
catalog record 


The difference between the insert length and 
the delete length (can be a negative number) 


Number of relative repetition numbers 
processed so far 


Displacement into variable-length field to 
the delete/insert location 


Save area for the control interval number of 
the base catalog record 


Save area for the control interval number 
Address of the dictionary 

Address of the index combination table 
Number of dictionary entries 

Number of index combination entries 
Address of the controller work area 


Address of the virtual storage obtained by a 
GETMAIN request 


Save area for the insertion length 

Length of the user-supplied insert data 
Address of the space management work area 
Address of the SMF record chain 


Address of the CTGPL used when a catalog 
management routine issues the LSPACE 
macro instruction 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 
552 (228) 


553 (229) 


554 (22A) 


555 (22B) 
556 (22C) 


560 (230) 


562 (232) 
562 (232) 


563 (233) 
564 (234) 


566 (236) 
569 (239) 
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Bytes and 
Bit Pattern 


1 


1 


1 


z 
1 


Field Name 
CCAFLG7 
CCALSP 


CCASMFEX 
CCASMFA 


CCASMFBR 


CCAONCE 
CCAROREQ 
CCAFEOV 
CCACRABU 


CCAFLG8 


CCADSRCL 
CCAVBUFI 
CCASCRA 
CCASCICK 
CCALPIND 
CCAVRIND 
CCALEOD 
CCAAUCAT 


CCAFLG9 


CCARABYC 
CCARAEOV 
CCARALRD 
CCARACR 
CCAUCRA 


CCARAACT 


CCARAICI 
CCARESUM 


CCANORBA 


CCASMFRD 
CCASMFCT 


CCASMFLG 
CCASMFG1 


CCASMFUC 
CCASMFDF 
CCASMFSR 


CCASMFAL 


CCASMFG2 
CCASMFLN 


CCACHAIN 
CCACI1 


Description 
Flag byte 7: 


LSPACE has been called by a catalog 
management routine 

SMF exit indicator 

Perform SMF ALTER processing during 
IGGPEXT and IGGPMOD processing 
The base catalog record is in a record area 
(buffer) for SMF processing 

Move only one set of fields 

Request-type is read-only 

Force end-of-volume 

CRA being built 


Flags byte 8: 


Recursive call for DEFINE space 

Number of volume records buffered 
Suppress CRA updates 

Suppress CRA control interval check 

Loop control in buffer scan for GETs 
Volume record buffer chain is to be checked 
End-of-file on low keys 

Volume has a user catalog 


Flags byte 9: 


Bypass catalog I/O 

CRA end-of-volume 

CRA CCR has been read 

CRA CCR checkpoint requested 

Use CRA CI number translate table before 
CRA GET 

CRA is active 

Inhibit catalog I/O 

Replace sum 

Increment sum 


Number of RBAs needed in control block 
structure 


Address of the SMF record 


Number of catalog records in the SMF record 
chain to be used in creating the SMF ALTER 
record 


SMF record flags: 
First flag byte 


Before calling the SMF-record-writing routine, the caller sets these bits to indicate 
what he has done or intends to do: 


Uncatalog—write SMF record type 67 
DEFINE—write SMF record type 63 

Data set, index, or nonVSAM data set has 
been scratched—write SMF record type 67 
ALTER—write SMF record type 63 
Reserved 


Reserved 


Amount of virtual storage obtained for the 
SMF record 


Control interval number save area 


Control interval number save area 


Catalog Communications Area (CCA)—Description and Format (continued) 


Offset 

572 (23C) 
575 (23F) 
578 (242) 


580 (244) 


584 (248) 


588 (24C) 


592 (250) 


594 (252) 
614 (266) 
634 (27A) 


637 (27D) 


640 (280) 
680 (2A8) 
684 (2AC) 


684 (2AC) 
686 (2AE) 
688 (2B0) 
690 (2B2) 


691 (2B3) 
692 (2B4) 


692 (2B4) 
694 (2B6) 
696 (2B8) 


697 (2B9) 
699 (2BB) 
700 (2BC) 
704 (2C0) 


-XXX 


Bytes and 
Bit Pattern 


3 
3 
Z 


20 
20 


N N WN 


-XXX 


p= 


Field Name 


CCACI2 
CCACI3 
CCAVARLN 


CCARRAB 


CCARBASE 


CCAVARPT 


CCADELN 


CCAVAR 
CCAVARI 
CCADELI1 


CCADEL2 


CCAXLATE 
CCARI4S 
CCABMINP 


CCABMTRK 
CCABMLIM 
CCABMMIN 
CCABMFLG 


CCABMST 
CCABMCHK 
CCABMSET 
CCABMCCK 
CCABMLST 


CCABMOUT 


CCABMONN 
CCABMOTR 
CCABMOFG 
CCABMOST 


CCABMPAD 
CCABMGOP 
CCABMPTR 


Description 


A second control interval number save area 
A third control interval number save area 


Number of bytes to be inserted into the 
record 


Address of the RAB containing the 
set-of-fields pointers where delete/insert 
processing is to begin. 


Address of a second RAB, similar to 
CCARRAB 


Address of the information to be inserted 
into the record 


Number of bytes to be deleted from the 
record 


Insert information save area 
A second insert information save area 


The control interval number of the first 
record in a series of records to be deleted 


The control interval number of the last 
record in a series of records to be deleted 


Translation work area 
IGGOCLC9 Register 14 save area 


Input parameters for the bit manipulation 
routine (IGGOCLBR) 


Starting track number 

Ending track number, or upper limit 
Minimum number of tracks required 
State and function code: 


State to set or condition to check 
Perform the check 

Set the state 

Perform a conditional check 
Last set required 

Reserved 


Reserved 


Output parameters for the bit manipulation 
routine (IGGOCLBR) 


Number of tracks 
Starting track number 
Output flags: 


State of bits 
Reserved 


Reserved 


Padding character 


Address of the current space map set of fields 


Address of the current bit mask byte 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and 
Offset Bit Pattern 
708 (2C4) 4 
712 (2C8) 2 
714 (2CA) 2 
716 (2CC) 2 
718 (2CE) 2 
720 (2D0) 4 
724 (2D4) 4 
728 (2D8) 4 
732 (2DC) 4 
736 (2E0) 4 
740 (2E4) 4 
744 (2E8) 40 
784 (310) 256 
784 (310) 248 
784 (310) 1 
-XXX XXXX 
785 (311) 239 
1024 (400) 1 
Tae wets 
»XXX XXX 
1025 (401) 3 
1028 (404) 4 
1032 (408) 1 
1033 (409) 3 
1036 (40C) 4 
1040 (410) 16 
1040 (410) 4 
1040 (410) 1 
1041 (411) 3 
1044 (414) 4 
1048 (418) 4 
1052 (41C) 4 
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Field Name 


CCABMEND 


CCABMBT |! 
CCABMBT 
CCABMBYT 
CCABMSTR 
CCABMWKI1 
CCABMWK2 
CCABMWK3 
CCABMWK4 
CCABMRBI!I 


CCABMRB2 


CCATEMPS 
CCAMNCAT 
CCAMNAT 
MNATTOP 
MNATFULL 


MNATFLGS 


MNATVAL 
MNATSCLS 


MNATARGI 


MNATARG2 
CCAMNLL 


CCAMNLEN 
CCAMNADR 
CCAARFWA 
ARFGMLEN 
ARFGMLP 
ARFLEN 
ARFGMADR 
ARFSBSCH 
ARFSBECH 


Description 


Address of the end of the current space map 
set of fields 


Number of bits—first byte 
Number of bits—last byte 
Number of full bytes 

Current bit mask starting track 
Work area 

Work area 

Work area 

Work area 


Address of the first RAB that points to the 
space map set of fields 


Address of the second RAB that points to the 
space map set of fields 


Compiler temporary work area 
Contiguous area for tracking 
Tracking buffer 

First byte in the buffer—flag byte 


Buffer is full 
Reserved 


Remainder of the buffer 
Flags for the most recent entry in the buffer 


Valid entry 
Class ‘S’ virtual storage 
Reserved 


Remainder of the first word of the most 
recent entry 


Second word of the most recent entry 


GETMAIN/FREEMAIN length 
list—end-of-list byte 


GETMAIN/FREEMAIN length 
GETMAIN/FREEMAIN address 
Spill routine work area 
GETMAIN length list 

End-of-list byte 

Length of GETMAIN 

Address for GETMAIN 

Address of first spill block 
Address of last spill block 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and 
Offset Bit Pattern 
1056 (420) | 
1... 
shies 
ses 
Lise 
size 
ira 
1057 (421) 3 
1060 (424) 348 
1060 (424) 4 
1064 (428) 8 
1408 (580) 4 
1412 (S84) 4 
1416 (588) 1 
1417 (589) 3 
1420 (58C) 4 
1424 (590) 4 
1428 (594) 4 
1432 (598) 4 
1436 (59C) 4 
1440 (SAO) 4 
2 
1442 (SA2) 2 
1444 (SA4) 1 
Lee 
ale 
seal 
or 
.XXX 
1445 (5A5) 3 
1448 (5A8) 4 
1452 (SAC) 8 
1460 (5B4) 8 
1468 (SBC) 
1476 (5C4) 4 
1480 (5C8) 4 
1480 (5C8) Z 


Field Name 


CCARVFG1 


RVCCAV 
RVARFI 
RVCMSFG 
RVESBO 
RVESBOR 
RVRPLMFG 
RVWG 


CCAREGS 


CCAMODNM 


CCABZSAV 
CCADSPWA 


CCACUMPL 


CCASBASE 


CCACRACI 

CCARAACB 
CCARARPL 
CCARARBA 
CCARAREC 


CCARALSA 
CCACRABT 


CCAFLG10 


CCAINCPL 
CCAPDMW 
CCACATAC 
CCARAFEV 
CCARARTC 


CCASUMTT 
CCADICTS 
CCARANCA 


CCARAVCA 


CCAVTS 
CCAREWKA 


CCASMFP 
CCASMFMD 


Description 


Recovery flags: 


CCA is valid 

Tracking data is incomplete 

Catalog management services function gate 
ESTAE backout is in control 

ESTAE backout register 

RPL management gate 

RPL WAIT gate 

Reserved 

Reserved 


Register 12, 13, and 14 save area 
(See ‘‘Diagnostic Aids”’ for details about the 
CCA register save area) 


Address of the user save area 
Load module name 


Address of the save area for IGGOCLBZ 
Address of DEFINE SPACE work area 


Address of the catalog management upgrade 
parameter list 


Reserved 


Save base control interval for upgrade 
process 


Address of the CRA record pointer array 
Address of the CRA ACB 

Address of the CRA RPL 

Relative byte address of the CRA 
Address of a CRA record 


Address of the CRA local save area 
Block/track value for CRA record 
construction 


Reserved 
Flag byte 10: 


Catalog parameter list is invalid 
Problem determination message 
Catalog is active 

Forced end of volume 

Recovery exit—return to caller 
Reserved 


Sum of the tracks in the CRA 
Data/index time stamp 


Start, end addresses of normal record buffer 
chain 


Start, end addresses of volume record buffer 
chain 


Volume time stamp 


Address of reusable data set processing work 
area 


Save area for SMF problem determination 


Module ID 
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Catalog Communications Area (CCA)—Description and Format (continued) 


Bytes and ide 


Offset Bit Pattern Field Name Description 

1482 (SCA) 1 CCASMFRC Reason code 

1483 (SCB) I CCASMFCD Return code 

1484 (SCC) 4 CCAPROBX Save area for CCAPROB 

1484 (SCC) 2 CCAMODDX Error module ID 

1486 (SCE) 2 CCAERCDX Error codes 

1486(5CE) | CCARESNX _ Reason code ° 
1487 (SCF) I CCARETRX Reason code 

1488 (5D0) 4 CCADGDGA Address of generation data group work area 
1592 (dD4) 12 CCAREQDQ RPL ENQ/DEQ parameter list 

1604 (SEO) 4 Reserved 


CTGCV—Catalog Control Volume List 


The CTGCYV is built by the issuer (primarily the Scheduler) of a Superlocate 
request by data set name for volume information. Catalog management uses 
the CTGCV to return to the caller the name of the catalog that contains the 
data set name. The CTGPL points to the CTGCV. 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 6 CTGCVVOL Volume serial number of the catalog named 
in CTGCVDSN. 

6 (6) 44 CTGCVDSN Name of the catalog in which the data set - 
name was located, or which needs to be 
opened to continue the superlocate. 

6 (6) 4 CTGCVDEV CVOL device type 

50 (32) 44 CTGCVCC An alias of the catalog (catalog connector). 


Returned only when the catalog is identified 
by the first qualifier of the data set name and 
the first qualifier is an alias of the catalog 
name. 


CTGFL—Field Parameter List 


The CTGFL is built before an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process an OS/VS2 user or master catalog record. 
The CTGFL defines one of the catalog record’s fields or a group of logically 
related fields (identified by a combination name). The CTGFL is used in two 
P situations: ; 


e It identifies a catalog record field to retrieve or update. The CTGPL 
contains the address of each CTGFL used in this way. 


e It identifies a catalog record field to compare against caller-supplied data. 
This is a ‘‘test’”” CTGFL and is addressed by another CTGFL. 


For UPDATE-Extend processing, one or three CTGFLs identify the volume 

information set(s) of fields to be extended. The catalog record fields 

identified by the CTGFL(s) are not explicitly retrieved or updated for the 1 
caller. J 
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When a catalog management routine is processing a CTGFL, the CTGFL’s 
address is in the CCA (CCAFLPT or CCATEST). 


Offset 
0 (0) 
1(1) 


2 (2) 
3 (3) 


4 (4) 


8 (8) 
12 (C) 
16 (10) 


Bytes and 
Bit Pattern 


Not X‘00’ 


XXXX XXX. 
...0 
aoe! 


VL 


Field Name 
CTGFLDNO 
CTGFLDCD 


CTGFLDEQ 
CTGFLDNE 
CTGFLDGT 
CTGFLDLT 
CTGFLDGE 
CTGFLDLE 
CTGFLDZ 
CTGFLDON 
CTGFLDMX 


CTGFLDGC 
CTGFLDRE 


CTGFLDTS 


CTGFLDWA 


CTGFLDNM 


CTGFLCHN 
CTGFLDAT 


CTGFLNG 
CTGFLPT 


Description 
Number of entries in CTGFLDAT 
Test condition: 


The CTGFL describes a field to be updated 
or retrieved. The CTGFL is pointed to by the 
caller's CTGPL (CTGFIELD entry). 


The CTGFL describes a test condition. This 


.CTGEFL is pointed to by another CTGFL. 


Test condition: 
Equal 
Not equal 
Greater than 
Less than 
Greater than or equal 
Less than or equal 
Test under mask for zeros 
Test under mask for ones 
Test under mask for mixed 


Type (group) code 
Test results: 


Reserved 
Successful test 
Test failed 


Work area: contains information about the 
catalog record’s field name from the 
dictionary 


Address of the field name 

Address of a CTGFL-for-tests, or 0 

Address and length, in the caller's work area, 

of: 

¢« Each field that was retrieved, if the 
request was LOCATE or LISTCAT. 


« New data to replace or add to data in the 
catalog record, if the request was 
UPDATE, DEFINE, or ALTER. 


« Data used to compare to catalog record 
fields, if the CTGFL isa 
CTGFL-for-tests. 


The length of the CTGFLDAT field is the 
CTGFLDNO value times 8 (two 4-byte 
fields): 


4-byte length of the data 
4-byte address of the data 
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CTGFV—Field Vector Table 


The CTGFV is built by the Access Method Services utility programs and 
contains addresses of user-supplied information fields and lists. The CTGFV 
is built when the user issues a DEFINE or ALTER command. If the user is 
creating a cluster, a CTGF'V is built for each catalog record that will be built 
to describe the cluster: that is, Access Method Services DEFINE processing 
builds a cluster CTGFV, a data CTGFV, and, if the cluster is key-sequenced, 
an index CTGFV. The CTGFV is pointed to by the CTGPL (CTGFVT). If 


Access Method Services builds more than one CTGFV, the cluster CTGF'V is 


pointed to by the CTGPL (CTGFVT) and the data and index CTGFVs are 
pointed to by the cluster CTGFV. 


Offset 
0 (0) 


1 (1) 


2 (2) 
3 (3) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 


28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
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Bytes and 
Bit Pattern 


- & fF bk HL 


Field Name 
CTGFVTYP 


CTGFVALN 
CTGFVGBS 
CTGFVCL 
CTGFVDTA 
CTGFVAIX 
CTGFVIDX 
CTGFVPTH 
CTGFVVOL 
CTGFVANM 


CTGFVPRO 


CTGFVAVL 
CTGFVRVL 
CTGFVNDC 
CTGFVDRC 


CTGFVRON 
CTGFVROF 


CTGFVELM 


CTGFVDCH 
CTGFVICH 
CTGFVVCH 
CTGFVIND 
CTGFVENT 
CTGFVSTY 


CTGFVOWN 
CTGFVEXP 
CTGFVCRE 
CTGFVVLT 
CTGFVRNG 
CTGFVDVT 


Description 


The CTGFV contains information used by 
the DEFINE routines to build a catalog 
record of the type: 


NonVSAM data set 

Generation data group (GDG) base 
Cluster 

Data set 

Alternate index 

Index 

Path 

Volume 

Alias name 


Catalog Management Services processing 
option flags: 


ALTER: Add volumes 
ALTER: Remove volumes 

No device-type conversion 
DEFINE a recoverable catalog 


Turn RACF indicator on 

Turn RACF indicator off 

Reserved 

Element number of CMSPCATR 

Reserved 

Address of the cluster’s data CTGFV 
Address of the cluster’s index CTGFV 
Address of the space CTGFV 

Address of the associated JCL DD statement 
Address of the entry name CTGFL 


Address of the security information CTGFL 
(passwords, codeword, and number of tries) 


Address of the owner identification CTGFL 
Address of the expiration date CTGFL 
Address of the creatign date CTGFL 
Address of the volume serial number list 
Address of the key range list 


Address of the device type CTGFL (for 
DEFINE NONVSAM only) 


2 


L 


Field Vector Table (CTGFV)—Description and Format (continued) 


Offset 
52 (34) 


56 (38) 


60 (3C) 
64 (40) 
68 (44) 
72 (48) 


76 (4C) 


80 (50) 


84 (54) 
88 (58) 


CTGPL—Catalog Parameter List 


Bytes and 


Bit Pattern 


4 


& f+ 4 fF 


Field Name 
CTGFVSPC 


CTGFVTTR 


CTGFVAMD 


CTGFVFSN 


CTGFVATR 
CTGFVBUF 
CTGFVLRS 

CTGFVLMT 


CTGFVEXT 
CTGFVGAT 


CTGFVUPG 


CTGFVNAM 


CTGFVPWD 
CTGFVWKA 


Description 


Address of the space allocation information 
CTGFL 

Address of the DSCB’s TTR CTGEFL (for 
DEFINE NONVSAM only) 


Address of the AMDSB CTGFL (for 
DEFINE CATALOG and DEFINE 
CLUSTER only) 

Address of the file sequence number CTGFL 
(for DEFINE NONVSAM only) 


Address of the data set attributes CTGFL 
Address of the buffer size CTGFL 
Address of the average record size CTGFL 


Address of the GDG limit CTGFL (for 
DEFINE GDG BASE only) 
Address of exception exit parameter list 


Address of the GDG attributes CTGFL (for 
DEFINE GDG BASE only) 
Address of RGATTR parameter list 


Address of the true name CTGFL (for 
DEFINE ALIAS only) 


Address of the related object’s password 


Address of the CRA feedback area 


The CTGPL is built before an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process an OS/VS2 master or user catalog record. 
The CTGPL defines the catalog management request and its options, the 
catalog record to be processed, and the OS/VS2 catalog that contains the 
record. The CTGPL is pointed to by register 1. When the catalog 
management routines build a CCA to support the request, the address of the 
CTGPL is put into the CCA (CCACPL). 


Offset 
0 (0) 


Bytes and 
Bit Pattern 


| 


Field Name 
CTGOPTNI 
CTGBYPSS 


CTGMAST 
CTGCI 
CTGUPD 
CTGREAD 
CTGNAME 


CTGCNAME 


CTGGENLD 


Description 
First option byte: 


Bypass the catalog management security 
verification processing 


Check the master password 

Check the control interval password 

Check the update password 

Check the read password 

The CTGENT field contains the address of a 
44-byte DSNAME, or a 6-byte volume serial 
number (padded with binary Os) 

The CTGENT field contains the address of a 
3-byte control interval number 

The CTGCAT field contains the address of a 
catalog’s 44-byte DSNAME. 

The CTGCAT field contains the address of a 
4-byte field containing a VSAM catalog’s 
ACB address 

Generic locate request 
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Bytes and 
Offset Bit Pattern 
11) 1 
1... 
ole 
oe ee 
rae ere 
oy (Pa 
a be 
nee X 
2 (2) 1 
MRK ole: 
O01. .... 
010. .... 
O11... 
100. .... 
ak ee 
5 ie 
0 
wll 
Bouse “aac | 
eee 0 
3 (3) 1 
VA's 
Oss 
hs ee 
elite 
..X XXXX 
4 (4) 4 
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Field Name 


CTGOPTN2 


CTGEXT 
CTGNSVS 
CTGERASE 
CTGSMF 
CTGREL 
CTGGTALL 
CTGPURG 
CTGVMNT 


CTGRCATN 


CTGGTNXT 
CTGDISC 
CTGOVRID 
CTGSCR 


CTGOPTN3 


CTGFUNC 
CTGLOC 
CTGLSP 
CTGUPDAT 
CTGCMS 


CTGSUPLT 
CTGGDGL 


_CTGSRH 


CTGNUM 
CTGAMO 


CTGOPTN4 
CTGLBASE 


CTGDOCAT 


CTGNPROF 


CTGENT 


CTGFVT 


Description 


Second option byte: 


Extend option (with UPDATE) 
Catalog cleanup request 

Erase option (with DELETE) 

Write SMF record option (with LSPACE) 
Reset to empty status 

Search all catalogs (with LISTCAT) 
Purge option (with DELETE) 

The caller is VSAM Open/Close/EOV: 
Volume Mount and Verify routine 
(IDA0192V) 

Return the catalog name (with generic 
LOCATE) 

Get-next option (with LISTCAT) 
Disconnect option (with EXPORT) 
Erase override option (with DELETE) 
Scratch space option (with DELETE 
NonVSAM) 

Reserved 


Third option byte: 


Specifies the caller-requested function: 
LOCATE 
LSPACE 
UPDATE 
A Catalog Management Services function 
(see CTGOPTNS) 
SUPERLOCATE function9 
GDG locate request—the caller supplied the 
base generation level (CTGWAGB field in 
CTGWA). 
Search the master catalog only. 
Search the user's catalog first (specified by 
CTGCAT or, if CTGCAT = 0, search the 
user's catalogs available to the caller via 
JOBCAT or STEPCAT DD statements, then 
search the master catalog) 
1=Search one catalog; 0=Search both 


The call is an OS/VS2 catalog management 
request 

The call is an OS catalog management 
request; the caller supplied a CAMLST 
parameter list that was translated into this 
CTGPL and CTGFLs. 


Fourth option byte: 


Locate the base level (with 
SUPERLOCATE-GDG only) 

If the needed catalog is not open, 
dynamically allocate and open it. 

Do not dynamically open the needed catalog. 
No RACF profile to be defined or deleted. 


Reserved 


Address of the catalog record identifier, as 
defined in CTGOPTN1. When the request is 
generic locate, byte 1 of the field pointed to 
by CTGENT is a length byte, followed by a 1 
to 43 character generic name. 

Address of the callers CTGFV 


Catalog Parameter List (CTGPL)——Description and Format (continued) 


Bytes and 
Offset Bk Pattern 


8 (8) 4 


12 (C) 
16 (10) 2 


16 (10) | 


17 (11) 1 
18 (12) 1 


19 (13) 
20 (14) 4 


Field Name 
CTGCAT 


CTGCVOL 


CTGWKA 
CTGDSORG 


CTGOPTNS 


CTGDEFIN 

CTGALTER 
CTGDELET 
CTGLTCAT 
CTGCNVTV 


CTGTYPE 


CTGTALIN 
CTGTGBS 
CTGTCL 
CTGTDATA 
CTGTFREE 
CTGTAIX 
CTGTINDX 
CTGTMCAT 
CTGTPGSP 
CTGTPTH 
CTGTUCAT 
CTGTVOL 
CTGTANM 
CTGTUPG 


CTGNOFLD 
CTGDDNM 


CTGNEWNM 


If the request is SUPERLOCATE: 


20 (14) 2 
22 (16) 1 

1. 

ihe 

salle 

seed 

XXXX 

23 (17) 1 


CTGFDBK 
CTGFBFLG 


CTGPAR 
CTGKEEP 
CTGGDGB 
CTGNGDSN 


Description 


Address of the catalog’s DSNAME or of a 
4byte field that contains the address of the 
catalog’s ACB, as specified in CTGOPTNI. 
Address of an OS/VS system-catalog catalog 
name area, if the request is 
SUPERLOCATE. The catalog name area 
contains the catalog’s DSNAME and, if the 
catalog is identified with an alternate 
DSNAME, the catalog’s alias. The OS/VS2 
Scheduler uses this information to build the 
catalog’s PCCB. 


Address of the caller’s work area 


Data set organization, if the request is 
SUPERLOCATE 


Catalog Management Services request 
options: 


DEFINE 
ALTER 
DELETE 
LISTCAT 
CONVERT 
Reserved 


Reserved 
Type of catalog record: 


NonVSAM data set 
Generation data group (GDG) base 
Cluster 

Data set 

Free 

Alternate index 
Index 

Master catalog 
Page space 

Path 

User catalog 
Volume 

Alias name 
Upgrade 


Number of entries contained in CTGFIELD 


Address of the JCL DD statement, if one is 
associated with this request 

Address of the new DSNAME, if the request 
is ALTER and the object’s name is being 
changed 


Feedback area 
Flags: 


Parallel mount 

Forced keep 

GDG Base located 

Generation data set name was generated (in 
the form ‘dsname.gxxxxvyy’) 

Reserved 


Reserved 
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Catalog Parameter List (CTGPL)—Description and Format (continued) 


Offset 


24 (18) 


28 (1C) 


CTG VL—Catalog Volume List 


Bytes and 
Bit Pattern 


4 


VL 


Field Name 


CTGJSCB 
CTGPSWD 


CTGFIELD 


Description 


Address of the JSCB 
Address of the caller-supplied password 


The 4-byte address of each CTGFL, to 
specify each catalog field to be processed. 
The length of CTGFIELD is the 
CTGNOFLD value times 4. 


The CTGVL is built by the issuer of a locate request for a data-set name. 
Catalog management uses the CTGVL to return to the caller the volume 
serial numbers of the volumes on which space is allocated to the data set. For 
superlocate requests, the CTGWA points to the CTGVL. 


Offset 
0 (0) 
6 (6) 
10 (A) 
12 (C) 
12 (C) 


12 (C) 
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Bytes and 
Bit Pattern 


6 
4 
2 


VL 


Field Name 
CTGVLVOL 
CTGVLDEV 
CTGVLSEQ 
CTGVLX 
CTGVLTTR 


Description 

Volume serial number. 
Device type. 

File sequence number. 
Volume list extension. 


For a single-volume data set, the TTR of its 
DSCB. 


For a multi-volume data set, a repetition of 
CTGVLVOL, CTGVLDEV, and 
CTGVLSEQ for the rest of the volumes. 


2 


CTGWA—Catalog Work Area 


The CTGWA is built by the caller of catalog management for most requests. 
The CTGPL points to the CTGWA. The work area has one format for a 
superlocate request and another format for all other requests. 


Bytes and 
Offset Bit Pattern Field Name Description 
Format for a Request other than Superlocate 
0 (0) 2 CTGWALNG Length of the work area. 
2 (2) VL * Data returned for DEFINE, DELETE, 


GENDSP, LISTCAT, LOCATE, LSPACE. 


Format for a Superlocate Request 


0 (0) 4 CTGWAVL Address of the CTGVL (volume list). 

4 (4) 2 CTGWALV Length of the volume list. 

6 (6) 2 CTGWAVCT Number of volume serial numbers returned 
in the volume list. 

8 (8) 2 CTGWAUCT Minimum number of volumes that must be 
mounted. 

The following two fields are for a GDG Base only: 

10 (A) 2 CTGWAGCT CTGGDGB in the CTGPL is set on, and 


CTGWAGCT gives the number of 
generations cataloged. 


e 12 (C) 4 CTGWAGB Address of a 4-byte field that contains the 
generation level to be used if CTGSUPLT 
and CTGGDGL in the CTGPL are set to 
one. If CTGGDGL is zero, the latest 
generation is used. 
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PCCB—Private Catalog Control Block 


A PCCB describes each user’s catalog to the OS/VS system. The PCCB is 
built when the user’s catalog is opened. If the catalog is already open for 
another user, a PCCB is built when the user’s JCL DD STEPCAT or 
JOBCAT statement specifies the catalog. The JSCB associated with the user 
task’s TCB points to the first PCCB. Other PCCBs available to the user’s 
task are chained from the first PCCB. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 4 PCCACRO Acronym of the control block—C*PCCB’ 
4 (4) 4 PCCNEXTP Address of the next PCCB in the PCCB 
chain, or zero. 
8 (8) 4 PCCPREVP Address of the previous PCCB in the PCCB 
chain, or zero. 
12 (C) 4 PCCSTATS Indicator flags 
12 (C) 1 PCCSTAT1 Flag byte 1: 
| ere PCCSTEPC The catalog represented by this PCCB is 
associated with a STEPCAT DD statement. 
P) eee PCCALIAS This PCCB contains an alias name for a 
user’s catalog. The catalog’s DSNAME is also 
in the PCCB. 
ey eee PCCACTIV The catalog represented by this PCCB is 
allocated and active. 
sal tees PCOSCVOL The catalag is an OS CVOL catalog 
«..X XXXX Reserved 
13 (D) 3 Reserved 
16 (10) 4 PCCACBP Address of the ACB for the user’s catalog. 
20 (14) 8 PCCDDNAM DDNAME for a dynamically allocated 
catalog. 
28 (1C) 44 PCCDSNAM Catalog’s DSNAME 
72 (48) 44 PCCTGCON Catalog’s alias (alternate DSNAME) 
116 (74) 6 PCVOLSER OS CVOL’s volume serial number 
122 (7A) 54 Reserved 
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PCTI—Private Catalog Termination Table 


The PCTT records the open status of user catalogs, and it enables proper 
cleanup and freeing of control blocks during task termination. The PCTT is 
built dynamically by IDACAT11, mapped by IDAPCTT, and pointed to by 
ASCBPCTT. There is one PCTT for each address space. 


Offset 
0 (0) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 


17 1) 
18 (12) 
20 (14) 


RPL—Request Parameter List 


Bytes and 
Bit Pattern 


4 


-XXXXXXX 


| 


Field Name 
PCTTID 
PCTTENBR 
PCTURR 


PCTFLGS1 
PCTTCL 


PCTTOPCT 
PCTTACB 


Description 

Acronym of the table—C‘PCTT’ 
Number of slots for ACB addresses 
Number of slots used for ACB addresses 
Reserved 

Flag byte 


Temporary close 
Reserved 


Reserved 
Open count 


ACB address slot 


The RPL contains user-request information and error feedback information. 
It also maintains information required by GET and PUT macro instructions. 


Offset 
0 (0) 
0 (0) 
11) 
2 (2) 


3 (3) 
4 (4) 
g (8) 


Bytes and 
Bit Pattern 


Liss: 
1 


oeXX XXXX 


4 
1 
1 


Field Name 
RPLIDWD 
RPLID 
RPLSTYP 
RPLREQ 


RPLGET 
RPLPUT 
RPLCHECK 
RPLPOINT 
RPLENDRE 
RPLERASE 
RPLVERIF 
RPLPFMTD 
RPLPFMTI 
RPLFRCIO 
RPLGETIX 
RPLPUTIX 
RPLSRCHB 
RPLMRKB 
RPLWRTB 


RPLLEN 
RPLPLHPT 
RPLECB 


RPLWAIT 
RPLPOST 


RPLFDBWD 


Description 

Identification word of the RPL: 
RPL identifier, X‘00 

RPL subtype, X‘10’ 

Request type: 


GET request 

PUT request 
CHECK request 
POINT request 
ENDREQ request 
ERASE request 
VERIFY request 
Preformat data 
Preformat index 
Force I/O request 
GETIX request 
PUTIX request 
Search buffer request 
Mark buffer request 
Write buffer request 


Length of the RPL 
Address of the PLH 


Address of the external ECB, or an internal 
ECB: 


The event has not yet completed 
The event has completed 
Reserved 


Reserved, if RPLECB is an internal ECB. 
Feedback word. 


Data Areas 369 


Request Parameter List (RPL)—Description and Format (continued) 


Offset 
12 (C) 


13 (D) 


13 (D) 


14 (E) 
14 (E) 
15 (F) 
16 (10) 


18 (12) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
40 (28) 


41 (29) 
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Bytes and 
Bit Pattern 


-& £ hf Lh FL SH NW 


Bee 


Field Name 


RPLSTAT 


RPLCHKI 
RPLEDRQI 


RPLFDBK 


RPLRTNCD 
RPLERREG 


RPLCNDCD 
RPLCMPON 
RPLERRCD 


RPLKEYLE 
RPLKEYL 


RPLSTRID 
RPLCCHAR 
RPLDACB 
RPLTCBPT 
RPLAREA 
RPLARG 
RPLOPTCD 
RPLOPT1 
RPLLOC 
RPLDIR 
RPLSEQ 


RPLSKP 
RPLASY 


RPLKGE 
RPLGEN 
RPLECBSW 


RPLOPT2 


RPLKEY 
RPLADR 
RPLADD 
RPLCNV 


RPLBWD 


RPLLRD 


RPLUPD 
RPLNSP 


Description 
RPL status flags: 


CHECK has been issued 
ENDREQ has been issued 
Reserved 


RPL feedback area (See “‘Diagnostic Aids” in 
OS/VS2 VSAM Logic for a list of RPL 
return codes and condition codes.) 


RPL return code 


RPL condition code 
Component issuing the code 
Error code 


Key length 


RPL string identifier 

Address of the control character 
Address of the caller's ACB 

Address of the user's TCB 

Address of the caller's record area 
Address of the caller's search argument 
Option flags 

Option flag byte 1: 


Locate mode 

Move mode 

Direct-search access 

Sequential access 

Skip sequential processing 
Asynchronous request 
Synchronous request 

Search key greater than or equal 
Search key equal 

Generic key 

Full key 

The RPLECB field contains the ECB’s 
address 


Option flag byte 2: 


Locate the record identified by a key 
Locate the record at the caller-specified 
relative byte address (RBA) 

Locate the control interval at the 
caller-specified RBA 

Process in backward direction 

Process in forward direction 

Locate or retrieve the last record in the data 
set 

Locate, retrieve, or store the record 
identified by the user's argument 
Update processing 

Note the string position 

Reserved 


Request Parameter List (RPL)—Description and Format (continued) 


Offset 
42 (2A) 


43 (2B) 
44 (2C) 


48 (30) 
52 (34) 
56 (38) 
60 (3C) 
60 (3C) 
62 (3E) 


63 (3F) 
64 (40) 
68 (44) 
69 (45) 
70 (46) 
72 (48) 


Bytes and 


Bit Pattern 


XXX 


1 


Yn oOo fF fF LF 


Field Name 


RPLOPT3 


RPLEODS 
RPLSFORM 
RPLBLK 


RPLVFY 
RPLFLD 
RPLFMT 


RPLALIGN 


RPLOPT4 


RPLNXTRP 
RPLCHAIN 


RPLRLEN 
RPLBUFL 


RPLRBAR 
RPLAIXPC 
RPLAIXID 
RPLAXPKP 


RPLDDDD 


RPLACTIV 
RPLEMLEN 
RPLERMSA 


Description 
Option flag byte 3: 


End of the user's output data set 
Special form on remote printer 
Block the records 
The records are unblocked 
UCS/FCB verify 
UCS fold 
Format type: 

UCS load 

FCB load 

Reserved 

Reserved 


Align the buffer and notify the operator 


Do not align the FCB buffer loads 


Reserved 


Address of the next RPL in the chain 


Length of the record 

Length of the user’s buffer 
Reserved 

RBA return location 
Alternate index pointer count 
Alternate index pointer type: 


Relative byte address 
Prime key pointer 
Reserved 


Reserved 

Relative byte address 
Reserved 

CHECK not issued 

Error message area length 


Address of the error message area 
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DIAGNOSTIC AIDS 


This chapter provides several aids that can be useful when you are trying to 
diagnose difficulties with OS/VS2 catalog management modules. These aids 
include: 


e A description of the cross-reference information published on microfiche 
cards. 


e A list of messages issued by OS/VS2 catalog management, 
cross-referenced to enable you to detect the module causing the message to 
be issued. 


e A list of macro instructions issued by catalog management and their 
functions. 


e A catalog debug aid that provides options you can select and activate upon 
termination of a catalog management request. 


e A description of a system-provided service (GTF—the generalized trace 
facility). 


e A description of the catalog communication area’s register save area. 
e A list of catalog management return codes and error codes. 


Additional aids can be found in other parts of the book and in the program 
listings. These include: 


e Register contents on entry to a module, which are under “INPUT” in the 
module’s prologues. 


e Use of registers and equated names for registers, which can be found under 
“NOTES” in the module’s prologues. 


e Error codes, which are under “EXIT-ERROR” in the module’s prologues. 


e A list of modules, their external procedure names, and their associated 
method of operation diagrams and program organization figures, which is 
in the ““Module Directory.” 


e A list of external procedure names and their modules, which is in the 
‘External Procedure Name Directory.” 


e A list of all the information in this book that is related to a module, which 
is in the “‘Index.”’ 


e A definition of terms and acronyms used in this book, and in the OS/VS2 
catalog management listings, which is in the ‘‘Glossary.”’ 
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Microfiche Cross-Reference Aids 


Microfiche cards in OS/VS2 Catalog Management Cross-Reference contain 
valuable cross-reference information that you should be aware of. Two types 
of information are available: 


e Symbolic-name usage table: lists each symbolic name that appears in the 


How To Read the Symbolic-Name Usage Table 


Microfiche cards in the OS/VS2 Catalog Management Cross-Reference 
microfiche package contain the symbolic-name usage table, or Symbol Where 
Used Report, for OS/VS2 catalog management listings. Three kinds of 
information are available from the table, as shown in 

Figure 45: 


DATE: 09/07/75 


SYMBOL 


ACBBUFSP 
ACBCAT 
ACBCBMWA 
ACBCRNCK 
ACBCRNRE 
ACBDDNM 


ACBDEB 
ACBDIR 
ACBDORGA 
ACBDOSID 
ACBDTFID 
ACBERFL 
ACBERFLG 
ACBEXFG 
ACBEXLST 
ACBID 
ACBIDVAL 
ACBIN 
ACBINFL 
ACBINRTN 
ACBKEY 
ACBLEN 
ACBLENG 


MODULE 


IEAVNP1A 
IDACAT11 
IDAO19€1 
IGCOAO5B 
IGCOBO5B 


IDACAT11 
IGGOCLAD 


IDACAT 13 
IEAVNP1A 
IDACAT11 
IGGOCLAD 
IGGOCLAD 
IFGO191X 
IFGO191Y 
IDACAT 11 
IGCOCOEC 
IDACAT 11 
IGGOCLAD 
IDAO19C1 
IEAVNP1A 
IGCOBO5B 
IDA0O19C 1 
IDACB2 

IDACAT11 


ACCESS 


MODULE 


IDACAT 12 


1GcOcodéC 


IDAO19C1 
IGGOCLAE 


IEAVNP 1A 
IFGO191X 
IDAO19C1 
IGGOCLAE 
IGGOCLAE 


IFGO200N 
IDA019¢C1 


IDA019C1 


IGGOCLAE 


IFGO191X 


IFGO191X 


IFGO191X 


IDA019C1 


catalog management source-code listings, which lists each module that 
refers to the symbolic name, and specifies how each module refers to the 
symbolic name. 


Macro-instruction usage table: lists each macro-instruction that is issued in 
catalog management listings, specifies the total number of times the 
macro-instruction is issued, lists each module that issues the 
macro-instruction, and specifies the number of times the module issues the 
macro-instruction. 


e A list of symbolic names—this includes field names, symbolic address 


SYMBOL WHERE USED REPORT 


ACCESS 


= £ ££ ZF 


WC 


(EXTERNAL SYMBOLS) 


MODULE 


IGGOCLAD 


IEAVNP1B 
IGGOCLBG 


IGCOBO5B 
IGCOCOéC 
IGGOCLBG 


IGGOCLBG 


IGCOAOSB 
IGGOCLAD 


IGcocodéc 
IGGOCLBG 
IGGOCLBG 


IGGOCLBG 


IGGOCLAD 


ACCESS 


MODULE 


IGGOCLAE 


IEAVNP11 


IGGOCLAD 


IGGOCLAE 
IGGOCLAE 


IGGOCLAD 


IGGOCLAE 


--- OS/VS2 VSAM CAT MGMT 


ACCESS 


MODULE 


IFGO191X 


IGGOCLAE 


IGGOCLBG 


IGGOCLAE 


IGGOCLBG 


ACCESS 


W 


names, return code names, constant/value names, flag-bit names, etc—in 
alphanumeric order from top to bottom on the page. 


Note: In the lower-right corner of each page, the lowest and highest name 
for the page is shown. 


PAGE 3 


MODULE ACCESS 


IGCOAO5B WwW 


IGGOCLBG W 


IGGOCLBG Ww 


ACCESS CODES: D 


= DEFINITION, R = READ, W 


Figure 45. Symbolic Name Usage Table 
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WRITE, C = COMPARE, E = EQUATE OPERAND, M = MACRO, 
SYMBOL ENTRIES: ACBBUFSP - ACBLENG 


A = ABSOLUTE, P = PARAMETER 


e A list of modules that refer to each symbolic name, in alphanumeric order 
from left to right across the page. 


e A code indicating how each module refers to the symbolic name: 


W-WRITE The data field or bit value was modified by at least one 
line of code in this module. If the module contains a 
statement: 


A=B 


then the module’s use of ‘A’ is to modify it (‘A’ appears 
to the left of an equate sign in a statement that is not 
an ‘IF’ statement.) 


R—READ The data field or value was referred to by at least one 
line of code in this module. If the module contains a 
statement: 


A=B 


then the module’s use of ‘B’ is to refer to it, using it to 
modify ‘A’ (‘B’ appears to the right of an equate sign in 
any type of statement). 


C~COMPARE _ The data field or value was compared against another 
value. If the module contains a statement: 


IF A = B, THEN ... 


then the module’s use of ‘A’ is to compare it to ‘B’ (‘A’ 
appears to the left of an equate sign in an ‘IF’ 
statement). Note that the module’s use of ‘B’ is to refer 
to it, not to compare it. 


Other codes are explained in the ‘Access Codes’”’ at the bottom of each page 
in the table. 


How To Read the Macro-Instruction Usage Table 


A microfiche card in the OS/VS2 Catalog Management Cross-Reference 
microfiche package contains the macro-instruction usage table, or Macro 
Where Used Report, for OS/VS2 catalog management listings. Three kinds of 
information are available, as shown in Figure 46: 


e A list of macro-instruction names in alphanumeric order from top to 
bottom. 


e A list of the modules that issue each macro-instruction, in alphanumeric 
order from left to right across the page. 


e The total number of times all catalog management modules issued the 
macro-instruction, and the number of times each module in the list issued 
the macro-instruction. 
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DATE: 09/07/75 
MACRO TOTAL # 


ABEND 1 
ABPCALL 1 
ACB 1 
ACBX 1 
ADDRESS 1 
AMCBS 


AMOREGN 
ASM1 
BLDL 
CALL 
CARD 
CATGODSP 
CATGOGC 1 


CCAASCIK 
CCACD1 
CCACPE2 
CCACPE3 
CCACPE4 
CCACPES5 
CCACPE6 
CCACPE7 
CCARABB 


8 
1 
2 
2 
5 
1 
1 
1 
CATGOSEQ 1 
‘ 
2 
1 
; 
1 
1 
2 
1 
1 
CCARABFL 1 


MACRO WHERE USED REPORT 


MODULE 


# 


IEAVNP11 
IEAVNP12 
IGCOAO5B 
IEAVNP11 
IGGOCLAP 


IDACAT11 
IEAVNP 12 


IGGMCDCL 
IEAVNP 1A 
IEAVNP11 
IDACB2 

IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAQ 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 


MODULE # 


IDACAT12 1 
IGGMCDCL 1 
IEAVNP11 1 
IGGOCLAQ 4 


--- OS/VS2 VSAM CAT MGMT PAGE 1 
MODULE # MODULE # MODULE # MODULE # 
IDACAT13 1 IEAVNPIA 1 IEAVNP1B 1 IEAVNP11 1 


Figure 46. Macro-Instruction Usage Table 


Messages 


MACRO ENTRIES: ABEND - CCARABFL 


Messages IDA001 through IDA022 are macro-instruction messages and refer to an incorrectly 
coded macro instruction. 


Message 
Number 


IDA00!1 
IDA002 
IDA003 
1DA004 
IDA005 
IDA006 
ID A007 
IDA008 
IDA009 


IDA010 
IDAO11 
IDAO18 


IDAO19 
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Message 
Text 


INVALID POSITIONAL PARAMETER, xxx - IGNORED 

xxx KEYWORD REQUIRED - NOT SPECIFIED 

INVALID VALUE, yyy, SPECIFIED FOR xxx KEYWORD 

xxx KEYWORD NOT VALID FOR EXECUTE FORM - IGNORED 
INVALID SUBLIST ITEM FOR xxx KEYWORD, yyy 

xxx VALUE, yyy, NOT VALID FOR LIST FORM 

LOGIC ERROR IN MACRO xxx 

INCOMPATIBLE SUBLIST ITEMS, yyy AND 2zz FOR xxx KEYWORD 


xxx CONTROL BLOCK KEYWORDS SPECIFIED - ONLY ONE 
ALLOWED 


EXIT ADDRESS REQUIRED FOR xxx KEYWORD - NOT SPECIFIED 
xxx IS NOT A VALID yyy KEYWORD - IGNORED 


VTAM KEYWORD, xxx, SPECIFIED WITHOUT SPECIFYING 
AM=VTAM 


KEYWORDS xxx and yyy ARE INCOMPATIBLE 


Macro Instructions 


Messages (continued) 


Message Message 
Number Text 
IDA020 VTAM SUBLIST ITEM, xxx, SPECIFIED FOR yyy KEYWORD 
WITHOUT SPECIFYING AM=VTAM 
IDA021 xxx and yyy KEYWORDS MUST BE SPECIFIED TOGETHER, BUT 
ONE IS MISSING 
IDA022 CONFLICTING SUBLIST ITEMS WERE SPECIFIED FOR xxx 
KEYWORD 
Message Message Detected Issued 
Number Text by by 
IECIO1IA M ddd, ser, jjj,sss,dsn IGGOCLBL IDA0192V 
IECI11E D, ddd,ser IGGOCLBL IDA0192V 
IECI13A ENTER PASSWORD FOR DATA SET IGGOCLBG 
dsn IGGOCLBM 
IGGOCLB6 
IEC114E D ddd [,ddn-n| IGGOCLBL 
IEC115I INVALID PASSWORD IGGOCLBG 
IGGOCLBM 
IGGOCLB6 
IEC116A REENTER IGGOCLBG 
IGGOCLBM 
IGGOCLB6 
IEC1301 ddn - DD STATEMENT MISSING IFGO191X 
IEC301A S JOB xxxxxxxx DSNAME dsn IGGOCLBM 


IEC3311 ccc-000, jjj, sss, fff IGGOCLAG IGGOCLAF 


(IGGPIORA) (IGGPEMSG) 


IGGOCLAG IGGOCLAF 
(IGGPIORA) (IGGPEMSG) 


IGGOCLAG IGGOCLAF 
(IGGPIORA) (IGGPEMIO) 


IEC3321 Vinviiinn 


IEC3331 teee,xx, ddd, iii 


The following tables list VSAM and OS/VS macro instructions and explain 
what they do. The macro instructions are divided into those that define 
control blocks and data areas (mapping macro instructions) and those that 
result in executable code (action macro instructions). 


Mapping Macro Instructions 


The following table lists macro instructions that define the format of control 
blocks and data areas used by VSAM modules. 


Macro 

Instruction Description and Issuing Modules 

AMCBS Maps the OS/VS2 catalog vectors table (AMCBS) 
See “Data Areas” for a description of the AMCBS. 

CVT Maps the communications vector table (CVT) 

F4DSCB Maps the format-4 Data Set Control Block (DSCB) 

IDAAMB Maps the Access Method Block (AMB) 


See ‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
AMB. 
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Macro Instructions That Define Data Areas (continued) 


Macro 
Instruction 


IDAAMBL 


IDAAMDSB 


IDAARDB 


IDABUFC 


IDADIWA 


IDAFOREC 


IDAIOMB 


IDAPCTT 


IDAPDPRM 


IDAPLH 


IDARMRCD 
IDAVVOLL 


IECDIOSB 


IECSDSL1 
IEESMCA 
IEFJESCT 
IEFJFCBN 
IEFJFCBX 
IEFJMR 
IEFPCCB 


IEFQMIOP 
TEFTCT 
IEFTIOT1 
IEFUCBOB 
IEZCTGCV 


TIEZCTGFL 


IEZCTGFV 
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Description and Issuing Modules 


Maps the Access Method Block List (AMBL) 
See ‘‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
AMBL. 


Maps the Access Method Data Set Statistics Control Block (AMDSB) 
See ‘Data Areas,” for a description of the AMDSB. 


Maps the Address Range Definition Block (ARDB) 
See “‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
ARDB. 


Maps the buffer control block (BUFC) 
See ‘‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
BUFC. 


Maps the data insert work area (DIWA) 

See “‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
DIWA. 

Maps the work area for VSAM Open/Close/EOV Modules 
IDAFOREC issues IDAPDPRM, IEFJFCBN, and IEFJFCBX. 


Maps the I/O management control block 
See OS/VS2 Data Areas for a description of the IOMB. 


Maps the private catalog termination table (PCTT) 
See ‘‘Data Areas’”’ for a description of the PCTT. 


Maps the VSAM Open/Close/EOV problem determination parameter 
list 


Maps the placeholder (PLH) 
See “‘Data Areas,” in OS/VS2 VSAM Logic, for a description of the 
PLH. 


Lists the record management return codes 


Maps the VSAM Open/EOV: Volume Mount and Verify volume serial 
number list 


Maps the I/O supervisor control block 
See OS/VS2 Data Areas for a description of the IOSB. 


Maps the SDSL1 

Maps the SMCA 

Maps the JESCT 

Maps the Job File Control Block (JFCB) 
Maps the Job File Control Block (JFCB) 
Maps the JMR 


Maps the Private Catalog Control Block (PCCB) 
See “‘Data Areas” for a description of the PCCB. 


Maps the QMIOP 

Maps the TCT 

Maps the task input/output table (TIOT) 
Maps the OS/VS Unit Control Block (UCB) 


Maps the catalog control volume list (CTGCV) 
See ‘‘Data Areas’’ for a description of the CTGCV. 


Maps the catalog field parameter list (CTGFL) 
See “Data Areas” for a description of the CTGFL. 


Maps the catalog field vector table (CTGFV) 


Macro Instructions That Define Data Areas (continued) 


Macro 
Instruction 


IEZCTGPL 


IEZCTGVL 


IEZCTGWA 


IEZDEB 
IEZIOB 

IEZJSCB 
IFGACB 


IFGRPL 


IGGCAXWA 


IGGCCA 


IGGMCDCL 


IGGMCMDM 
IGGMCMWA 
IGGMCTRC 
IGGMDRWA 
IGGMF4WA 
IGGMGVO 
IGGMSAWA 
IGGMUPDE 


IGGMVEDC 
IGGSHWPL 
IHADCB 
IHADCBDF 
IHARB 
IHASRB 


IKJPSCB 
IKJTCB 
SGIDA401 
XCTLTABL 


Description and Issuing Modules 


See ‘‘Data Areas” for a description of the CTGFV. 


Maps the catalog parameter list (CTGPL) 
See ‘‘Data Areas” for a description of the CTGPL. 


Maps the catalog volume list (CTGVL) 
See ““Data Areas’’ for a description of the CTGVL. 


Maps the catalog scheduler work area (CTGWA) 
See “Data Areas’ for a description of the CTGWA. 


Maps the OS/VS Data Extent Block (DEB) 
Maps the OS/VS Input/Output Block (IOB) 
Maps the OS/VS Job Step Control Block (JSCB) 


Maps the access method control block (ACB) 
See “Data Areas” for a description of the ACB. 


Maps the request parameter list (RPL) 
See ‘Data Areas” for a description of the RPL. 


Maps the catalog auxiliary work area (CAXWA) 
See “‘Data Areas” for a description of the CAXWA. 


Maps the catalog communications area (CCA) 
See ‘Data Areas” for a description of the CCA. 


Contains the commonly used control block formats and constants for 
catalog management modules 


IGGMCDCL issues AMCBS, AMOREGN, COMREGN, CVT, 
IEZCTGCV, IEZCTGFL, IEZCTGFV, IEZCTGPL, IEZCTGWA, 
IFGACB, IGGCAXWA, IGGCCA, IGGMCTRC, and IKJTCB. 


Maps the catalog management commonly-used record structures 
Maps the catalog management services work area 

Lists the catalog management return codes 

Maps the catalog DSCB read-in work area 

Maps the Catalog Management format-4 DSCB work area 
Maps the volume information set of fields 

Maps the Catalog Management: Suballocate work area 


Defines the commonly-used declarations for VSAM Catalog 
Management: Update-Extend modules 


IGGMUPDE issues IDAAMDSB, IGGMCDCL, IGGMCMDM, 
IGGMSAWA, and IGGMVEDC. 


Maps the Volume Catalog Record 

Maps the SHOWCAT input/output parameter list. 
Maps the OS/VS Data Set Control Block (DCB) 
Maps the OS/VS Data Set Control Block (DCB) 
Maps the OS/VS Request Block (RB) 


Maps the VS2 service request block 
See OS/VS2 Data Areas for a description of the SRB. 


Maps the OS/VS PSCB 

Maps the task control block (TCB) 

Lists the VSAM SYSGEN global definitions 
Maps the OS/VS XCTL table 
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Action Macro Instructions 


This table lists the macro instructions that generate 


executable code. 


Macro 
Instruction 


ADDREC 


CALLSF(xxxx) 


CALL EXIT 
CATLG 


CATPROB 
CLOSE 
COMB 


DELETE 
DELREC 
DEQ 
DEVTYPE 
DICT 
ENDREQ 
ENQ 
ERASE 
EXCP 
FREEMAIN 
GET 
GETMAIN 
GETREC 
IGGMEND 
IGGMODUL 
IGGMPROC 
LOAD 
MODESET 
OPEN 

PUT 
RESERVE 
SMFWTM 
SYNCH 
TIME 
WAIT 
WTO 
WTOR 
XCTL 
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Description 

Calls IGGPPAD to write a new record into the catalog 
Transfers control to procedure IGGPxxxx 

Returns control to the caller of the procedure 


Loads the address of the catalog parameter list (CTGPL) into register 1 
and issues SVC 26 


Problem determination 
VSAM CLOSE: Disconnect a user from a VSAM data set 


Generates combination name entries in the VSAM combination name 
index table 


(Same as OS/VS DELETE macro instruction) 

Calls IGGPPDE to erase a catalog record 

(Same as OS/VS DEQ macro instruction) 

Determine the direct-access device type 

Generates entries in the catalog field name dictionary 
Terminate a VSAM record processing request (such as GET or PUT) 
(Same as OS/VS ENQ macro instruction) 

Delete a VSAM record 

(Same as OS/VS EXCP macro instruction) 

Releases virtual storage obtained by a GETMAIN 

Retrieves a record from a data set on a direct-access device 
Obtains virtual storage for a temporary work area 

Calls IGGPGET to retrieve a catalog record 

Generates code at the end of Catalog Management modules 
Generates header code for Catalog Management modules 
Generates header code for Catalog Management procedures 
(Same as OS/VS LOAD macro instruction) 

(Same as OS/VS MODESET macro instruction) 

Connect a user’s program to a VSAM data set 

Write a record into the VSAM data set 

(Same as OS/VS RESERVE macro instruction) 

Write the SMF message into the SMF data set 

(Same as ISAM SYNCH macro instruction) 

Obtain the correct time from the OS/VS system time-of-day clock 
(Same as OS/VS WAIT macro instruction) 

Write a message to the operator (no reply) 

Write a message to the operator (a reply is expected) 


Transfer control (OS/VS XCTL macro instruction) 


~S 


Using the VSAM Catalog Debug Aid 


Defining Debug Aid Options 


Selecting Debug Options 


The VSAM debug catalog aid allows the PSR to exercise certain options when 
VSAM catalog management requests terminate. These options include 
trapping, issuing a problem determination message, and retaining the CCA 
across ABEND dumps. They can be selected in any combination, and you can 
specify that the trap and message options be activated upon termination of 
(1) all requests, (2) only those requests that generate a nonzero return code 
in CCACD1, (3) only those requests that generate an abnormal return code 
in CCACD1, or (4) only those requests that generate a specific return code in 
CCACD1. 


Debug aid options are defined by storing values and setting bits within the 
CVTAMFF field in the CVT. The PSR can use the CPU manual procedure 
AM (alter main storage) to modify the CVTAMFF field. (Note, however, 
that bits 0-3 of CVTAMFF must not be changed.) 


You accomplish debug activity by storing a nonzero value (X‘01’ — X‘FF’) 
into CVTAMFF + 1 (the CVT’s location + X‘109’) and X‘O7FE’ (a BR 14 
instruction) into bytes 3 and 4 of CVTAMFF (CVT?’s location + X‘10A’). 
The nonzero value you store determines the scope of the debug activity, as 
follows: 


x‘O1’ Exercise options upon termination of all requests. 
X‘02’ Exercise options only when the catalog return code is nonzero. 
X‘03’ Exercise options only when the catalog return code is not a normal 


return code (0, 8, 36, 40, 44, 76, 140 (reason code 40), 188, and 240 are 
considered normal). 


X‘04’ ~ X°FF’ Exercise options only when the catalog return code equals the value 
stored. 


Each option selected will be exercised only when the catalog termination 
routine determines that the catalog return code (in CCACD1) falls within the 
defined scope. 


The trap option is activated by setting a hardware address stop, a DSS “AT”’, 
or a VM ADSTOP at the location of the BR 14 instruction contained in the 
low-order two bytes of CVTAMFF (the CVT’s location + X‘10A’). The 
catalog termination routine executes a BALR R14, R15 instruction to pass 
control to the BR 14 instruction. 


Register contents at the time of the debug trap are: 


Register Contents 


0 CPL bytes 0, 1, 2, and 16 (the type of catalog management request can be 
derived from the information contained in these bytes) 

| Contents of CCAPROB (module ID, error code, and return code) 

11 Pointer to CCA 

14 Return address 

15 Address of trap instruction 


To cause determination message IEC331I to be issued, set bit 5 (X‘04’) of 


CVTAMFF (the CVT’s location + X‘108’) to 1. 
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To include the CCA in ABEND dumps, set bit 7 (X‘01’) of CVTAMFF to 1. 
This option can be used independently of the other options. 
CVT 
CVTAMFF 
108 109 10A 
Scope of 
debug activity 
1 = Retain CCA 
1 = Issue message 
Generalized Trace Facility 


The Generalized Trace Facility (GTF) can be used to record information 
about VSAM processing at the time of an error. If GTF is active in the 
OS/VS system, GTF is used to trace VSAM control blocks when there is an 
error. 


GTF is used to record the contents of the ACB, AMBL, AMBs, AMDSBs, 
and TIOT entry for the data set being processed when the error occurred. 


| To format and print GTF records, use the PRDMP service aid with 
‘“‘USR=(FFF,FF5)”’ specified in the EDIT statement. 


Additional information on GTF and PRDMP is contained in OS/VS2 System 
Programming Library: Service Aids. 


Catalog Communication Area Register Save Area 


A catalog communication area (CCA) is built for every call to catalog 
management. The CCA contains a register save area (CCAREGS) that 
allows the PSR (programming systems representative) to follow the flow of 
control from one catalog management procedure to another, through each 
procedure called to process the request. 


The contents of registers 12, 13, and 14 are put into CCAREGS whenever a 
catalog management procedure is entered. The current value of register 13 is 
the address of the latest entry in CCAREGS. 


If an external catalog management procedure is entered from another catalog 
management procedure, three words are saved as follows: 


e the first word contains the contents of register 12—the calling procedure’s 
base address, 


e the second word contains the contents of register 13—a pointer to the 
previous 12-byte entry in the register save area (CCAREGS), and 


e the third word contains the contents of register 14—the return address in 
the calling procedure. 


Immediately after registers 12, 13, and 14 are saved (at register 13 + 12 
(decimal)), register 12 is updated to contain the ‘‘called’’ procedure’s base 
address. Register 13’s value is increased by 12, so that it points to the latest 
entry in CCAREGS. While a catalog management procedure is processing, 
register 11 contains a pointer to the beginning of the CCA. 
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Error Return Codes 


Note that backward movement is not recorded in the trace table. For 
example, if procedure B returns to procedure A, the return is not shown in the 
register Save area. 


VSAM sets error codes in the RPL and the ACB. Error codes set in the RPL 
are listed and explained in OS/VS Virtual Storage Access Method (VSAM) 
Programmer’s Guide andin OS/VS2 VSAM Logic. Those set in the ACB 
to indicate open, close, or end of volume errors are listed and explained in 
OS/VS2 VSAM Logic. 


OS/VS2 catalog management sets error and reason codes in CCAPROB. 
(For a description of the CCA, see “Catalog Management Control Block 
Descriptions” in the “‘Data Areas’’ section of this publication.) CCAPROB 
includes an identification of the catalog management module that set the code 
(CCAMODID), a reason code (CCAREASN), and a return code 
(CCACD1), which appears in register 15. Complete explanations of the error 
and return codes, together with the appropriate programmer responses are 
given in the description of message IDC30091 in OS/VS Message Library: 
VS2 System Messages. Brief descriptions of the return codes are given 
below: 


Catalog Management Error Codes 


Return Code 

Set in CCA’s Symbolic 

CCAPROB Field Name Meaning of Return Code 

0 (0) RCS Operation completed successfully. 

4 (4) RCCAT An error occurred while performing open/close 
processing for a VSAM catalog or catalog recovery 
area. If no STEPCAT or JOBCAT DD statement was 
supplied, dynamic allocation may have failed because 
the volume is allocated exclusively. The volume may be 
allocated exclusively because (1) the DD statement 
specified deferred mount, (2) the volume count is 
greater than the unit count on the DD statement, or (3) 
a previous Access Method Services command 
demounted the volume and changed the allocation of 
the volume to exclusive. 

8 (8) RCENT Entry does not exist, if action is one that locates an 
entry, or entry already exists, if action is one that adds 
an entry to a catalog. 

20 (14) RCINSP Not enough space is available in the catalog data set. 
Another extent cannot be obtained, because there is no 
more space on the volume in which the catalog resides 
or the maximum number of extents has been reached. 

24 (18) RCIOL Permanent read error in VSAM catalog. 

28 (1C) RCIONL Permanent I/O error in VSAM catalog. 

32 (20) RCINCPL Error was detected in the catalog parameter list 
(CTGPL). 

36 (24) RCDSNF Data set was not found. 

40 (28) RCVLSZ Volume list or work area is too small—the required 


length value is returned in the feedback field. 
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Catalog Management Error Codes 


Return Code 
Set in CCA’s 


CCAPROB Field 


44 (2C) 


48 (30) 


52 (34) 


56 (38) 
60 (3C) 
64 (40) 


68 (44) 
72 (48) 
76 (4C) 


80 (50) 


84 (54) 
88 (58) 
92 (5C) 
94 (SE) 


96 (60) 


98 (62) 


102 (66) 


104 (68) 
106 (6A) 
108 (6C) 
112 (70) 


116 (74) 
120 (78) 


124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 


Symbolic 
Name 


RCVLSM 


RCINFUNC 


RCIOU 


RCSEC 
RCINENT 
RCNAME 


RCNOSP 
RCNMNTD 
RCNUNIT 


RCRELOP 


RCDATE 
RCCRAOP 
RCDSEXT 
RCOBTAIN 


RCSPANCK 


RCRENAME 


RCSCRTCH 


RCCATEX 
RCNTFMT4 
RCINFNAM 
RCINFPL 


RCCATBAL 
RCSYSFLD 


RCINCI 
RCBLKVCK 
RCINPTR 
RCMISPAR 
RCINCNPM 
RCINENTN 


Meaning of Return Code 


Work area is too small; system is unable to return 
required size. 


Operation is not a valid one. 


I/O error was detected on a user volume. An attempt 
to modify the VTOC of the volume on which a 
user-specified data set is being defined or modified 
failed because of a read or write error. 


Password 1s incorrect. 
Catalog record type is invalid. 


Data set or index catalog record associated with the 
cluster or alternate index catalog record was not found. 


No space is available on a user volume. 
User volume is not mounted. 


Unit is not available for mounting user volume or 
volume not mounted. 


Invalid related object. The object specified in the 
RELATE parameter of the DEFINE command does 
not exist or is improper for the object being defined. 


Purge date has not expired. 
Error with a catalog recovery area define operation. 
Data set has reached the maximum number of extents. 


An OS/VS DADSM Obtain request failed during a 
VSAM catalog delete request. 


Error in specifying key length, key position, or record 
size for an alternate index or a spanned cluster. 


An unusual condition occurred during ALTER name 
of a unique or nonVSAM data set. 


An OS/VS DADSM Scratch request failed during a 
VSAM delete request for a unique or nonVSAM data 
set. 


Catalog exists. 
A format-4 DSCB processing error was encountered. 
Field name is invalid. 


Field parameter list (CTGFL) contains invalid 
parameters. 


Catalog records are invalid. 


User attempted to modify a system field or nonexistent 
field. 


Control interval number is invalid. 

User provided a work area outside his address space. 
Pointer is not valid. 

Required parameter is missing. 

Specified parameters are inconsistent or conflicting. 


Entry name is invalid. 


Catalog Management Error Codes 


Return Code 

Set in CCA’s Symbolic 

CCAPROB Field Name Meaning of Return Code 

148 (94) RCVOLOWN Volume is already owned by another VSAM catalog. 

152 (98) RCDNECAT _ User attempted to delete a catalog that is not empty. 

156 (9C) RCNOSPSA No space available to suballocate. 

160 (AO) RCVNDSPD _ Deletion of space object did not cause volume to be 
deleted. 

164 (A4) RCINSSWA _ Not enough storage is available for work area. 

168 (A8) RCINVDTY _ Specified device-type is not supported. 

172 (AC) RCDUPNVL Volume has duplicate data space name. 

176 (BO) RCNSPVTC No space available on VTOC for DSCB. 

180 (B4) RCDSNEND _ Data space was not found. 

184 (B8) RCDSO Data set is currently open, so the catalog record cannot 
be modified. 

188 (BC) RCCATUNA The catalog is unavailable. 

192 (CO) RCMLRSZ Maximum logical record length specified is greater 
than 32,761 for a nonspanned data set. 

196 (C4) RCMCISZD Data component control interval size specified is 
greater than 32,767. 

200 (C8) RCMCISZI Index component control interval size specified is 
greater than maximum block size of index device. 

204 (CC) RCKEYINC _ Key extends beyond end of record. 

208 (DQ) RCBUFSIZ Buffer size is too small. 

212 (D4) RCSIZCAL Control interval size cannot be calculated. 

216 (D8) RCVTCBAL  Volume’s VTOC is invalid. 

220 (DC) RCDOSVTC DOS VTOC cannot be converted to OS/VS VTOC. 

224 (EO) RCMXGRP Catalog record has exceeded the maximum number of 
sets of fields allowed. 

226 (E2) RCTSAUTH _ Test authorization failed. 

228 (E4) RCLOCKER _ Error detected in time-of-day clock. 

230 (E6) RCHIGH VSAM catalog retrieve of a control interval failed to 
get a low-range record from the VSAM catalog. 

232 (E8) RCSMFER Error detected in SMF processing. 

234 (EA) RCLEOD End of data encountered while reading the low data 
key range of the VSAM catalog. 

236 (EC) RCSPMAPE _ Error detected in scanning the space map. 

238 (EE) RCNOUCEN Novuser catalog entry in the master catalog for convert 
volume processing. 

240 (FO) RCINDER Required DD statement missing. 

242 (F2) RCEFRMPH _ A physical I/O error occurred during an erase of the 
data set being deleted. 

244 (F4) RCEF Erase operation failed—-DELETE operation was not 


performed. 
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Catalog Management Error Codes 


Return Code 

Set in CCA’s Symbolic 

CCAPROB Field Name Meaning of Return Code 

248 (F8) RCVOLENT The volume catalog record (identified with a 


caller-specified volume serial number) was not found. 


250 (FA) RCEFRM VSAM record management found a logical error 
during erase processing while deleting a VSAM data 
set. 

252 (FC) RCEE Error was detected, and the operation was not 


completed. 


Alphabetic List of the Catalog Management Error Return Code 
Symbolic Names 
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Name Code Name Code 
RCBLKVCK _— 128 (80) RCIOU 52 (34) 
RCBUFSIZ 208 (DO) RCKEYINC 204 (CC) 
RCCAT 4 (04) RCLEOD 234 (EA) 
RCCATBAL _ 116 (74) RCLOCKER 228 (E4) 
RCCATEX 104 (68) RCMCISZD 196 (C4) 
RCCATUNA _ 188 (BC) RCMCISZI 200 (C8) 
RCCRAOP 88 (58) RCMISPAR 136 (88) 
RCDATE 84 (54) RCMLRSZ 192 (CO) 
RCDNECAT _ 152 (98) RCMXGRP 224 (EO) 
RCDOSVTC 220 (DC) RCNAME 64 (40) 
RCDSEXT 92 (5C) RCNMNTD 72 (48) 
RCDSNF 36 (24) RCNOSP 68 (44) 
RCDSNEND __ 180 (B4) RCNOSPSA 156 (9C) 
RCDSO 184 (B8) RCNOUCEN 238 (EE) 
RCDUPNVL _ 172 (AC) RCNSPVTC 176 (BO) 
RCEE 252 (FC) RCNTFMT4 106 (6A) 
RCEF 244 (F4) RCNUNIT 716 (4C) 
RCEFRM 250 (FA) RCOBTAIN 94 (SE) 
RCEFRMPH 242 (F2) RCRELOP 80 (50) 
RCENT 8 (08) RCRENAME 98 (62) 
RCHIGH 230 (E6) RCS 0 (0) 
RCINCI 124 (7C) RCSCRTCH 102 (66) 
RCINCNPM _ 140 (8C) RCSEC 56 (38) 
RCINCPL 32 (20) RCSIZCAL 212 (D4) 
RCINDER 240 (FO) RCSMFER 232 (E8) 
RCINENT 60 (3C) RCSPANCK 96 (60) 
RCINENTN _— 144 (90) RCSPMAPE 236 (EC) 
RCINFNAM __ 108 (6C) RCSYSFLD 120 (78) 
RCINFPL 112 (70) RCTSAUTH 226 (E2) 
RCINFUNC 48 (30) RCVLSM 44 (2C) 
RCINPTR 132 (84) RCVLSZ 40 (28) 
RCINSP 20 (14) RCVNDSPD 160 (AO) 
RCINSSWA _ 164 (A4) RCVOLENT 248 (F8) 
RCINVDTY — 168 (A8) - RCVOLOWN 148 (94) 
RCIOL 24 (18) RCVTCBAL 216 (D8) 
RCIONL 28 (1C) 


GLOSSARY 


Following is a list of acronyms and abbreviations of terms 
used in this book and in the VSAM code listings. If you do 
not find the term you are looking for, refer to the index or to 
the publication, 1BM Data Processing Glossary, GC20-1699. 


Acronyms and Abbreviations 
ABEND: abnormal end 

ACB: access method control block 

ADR: addressed processing or addressed 
ADDR: same as ADR 

AIX: alternate index 

AMB: access method block 

AMBL: access method block list 

AMCBS: access method control block structure control block 
AMDSB: access method data statistics block 
ARDB: address range definition block 

ASCB: address space control block 

ASM: auxiliary storage manager 

ATIOT: alternate task input/output table 
BISAM: basic indexed sequential access method 
BLK: block, control interval 

BUFC: buffer control block 

CA: control area 

CAXWA: catalog auxiliary work area 

CCA: catalog communication area 

CCB: command control block 

Cl: control interval 

CIDF: control interval definition field 

CMS: VSAM catalog management services 
CNV: control interval or control-interval processing 
CPA: channel program area 

CPL: catalog parameter list (CTGPL) 

CRA: catalog recovery area 

CTGCYV: catalog control volume list 

CTGFL: field parameter list (FPL) 


CTGFYV: field vector table (FVT) 
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CTGPL: catalog parameter list (CPL) 
CTGVL: catalog volume list 
CTGWA: catalog work area 

CVT: communications vector table 
DCB: data control block 
DDNAME: data definition name 
DEB: data extent block 

DIR: direct processing 

DIWA: data insert work area 
DSCB: data set control block 
DSNAME: data set name 

DSORG: data set organization 
ECB: event control block 

EDB: extent definition block 
ENDREQ: end-the-request command 
EOD: end of data 

EOF: end of file 

EOV: end of volume 

ERFLG: error flags 

ESDS: entry-sequenced data set 
EXCD: exceptional conditions 
EXCP: execute channel program 
EXLST: exit list 

Ext Proc: external procedure 

FKS: full key search 

Fn: format n 

FPL: field parameter list (CTGFL) 
FS: free space 

FVT: field vector table (CTGFV) 
GC: type code (group code) 

GDG: generation data group 

GEN: generic key search 

GET: retrieve-a-record command 
GO: Set of fields (group occurrence) 


GOP: Set-of-fields pointer (group occurrence pointer) 
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ICWA: index create work area PSW: program status word 

ID: identifier PUT: write-a-record command 

IICB: ISAM interface control block QISAM: queued indexed sequential access method 
IMWA: index modification work area RAB: record area block 

Int Proc: internal procedure RACF: resource access control facility 

I/O: input/output RB: request block 

IOB: input/output block RBA: relative byte address 

ISAM: indexed sequential access method Rn: general-purpose register n 

IXSPL: index search parameter list RDF: record definition field 

JFCB: job file control block REP: replication 

JSCB: job step control block RPL: request parameter list 

KEQ: search on key equal RPLE: RPL extension for ISAM Interface processing 
KEY: keyed accessing RRDS: relative record data set 

KGE: search on key greater or equal RTN: routine 

KSDS: key-sequenced data set SCIB: search compressed index block 

L: link SEQ: sequential or sequential processing 
LOC: locate SKP: skip sequential or skip sequential processing 
LPMB: logical-to-physical mapping block SMF: system management facilities 
MACR: macro instruction reference STRNO: number of RPL strings 

MOD: module SVC: supervisor call 

MSS: Mass Storage System TCB: task control block 

n: integer number TIOT: task I/O table 

NSI: next sequential instruction TSO: time sharing option 

NSP: next string position UCB: unit control block 

NUP: no update UPD: update mode (or data modify) 
O/C/EOV: open/close/end of volume USVR: user security verification routine 
OFLG: open flags VL: variable length 

OPTCD: option code VM: virtual memory 

OS/VS: operating system/Vvirtual storage VSAM: virtual storage access method 
PCCB: private catalog control block VSRT: VSAM shared resource table 
PCTT: private catalog termination table VTOC: volume table of contents 

PL/I: programming language/one WTG: where-to-go table 

PL/S: programming language/systems XCTL: transfer control (macro instruction) 
PLH: placeholder list 


PLHDR: placeholder header 
PROC: procedure 


PSR: programming systems representative 
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Definitions of Terms Used in This 
Book 


Access Method Services: A multifunction service program that 
defines VSAM data sets and allocates space for them, 
converts indexed sequential data sets to key-sequenced data 
sets with indexes, modifies data-set attributes in the catalog, 
reorganizes data sets, facilitates data portability between 
operating systems, creates backup copies of data sets and 
indexes, helps make inaccessible data sets accessible, and lists 
data-set records and catalog entries. 


alias: A 1 to 44-character sequence that allows a user’s 
program to refer to a nonVSAM data set or user's catalog 
without using the data set’s or catalog’s dsname. An alternate 
dsname for a nonVSAM data set or user’s catalog. 


alternate DSNAME: ( See alias.) 


alternate index: A collection of index entries organized by the 
alternate keys of its associated base data records. 


alternate index cluster: The data and index components of an 
alternate index. 


base catalog record: The first catalog record (control interval) 
that describes the VSAM object. This record contains the 
object’s data set name, cluster name, or volume serial number 
in the ENTNAME field. This record also contains the header 
fields required for the object. The base catalog record can 
contain set-of-fields pointers that point to sets of fields in the 
base catalog record, or that point to sets of fields in extension 
records (vertical extension). The base catalog record’s 
extension pointer can point to an extension record (the 
horizontal extension) that continues the information 
(set-of-fields pointers) contained in the base catalog record. 


candidate volume: A direct-access storage volume that has 
been defined in a VSAM catalog as a VSAM volume; VSAM 
can automatically allocate space on this volume, as needed. 


catalog: ( See master catalog and user catalog.) 
catalog recovery area: ( See CRA.) 


cluster: A combination of related VSAM data sets, identified 
by one name in a VSAM catalog and requiring a single DD 
statement. A key-sequenced data set and its index form a 
cluster; an entry-sequenced data set alone forms a cluster. 


collating sequence: An ordering assigned to a set of items, such 
that any two sets in that assigned order can be collated. As 
used in this publication, the order defined by the System/370 
8-bit code for alphabetic, numeric, and special characters. 


compendium: A compendium gathers together and presents in 
concise form all the essential facts and details about a VSAM 
functional unit. 


component: A named, cataloged collection of stored records. 
The lowest member in the data structure hierarchy. A data 
set contains at least one component, and the component can 
contain no subsets. 


control area: A group of control intervals used as a unit for 
formatting a data set before adding records to it. Also, ina 
key-sequenced data set, the set of control intervals pointed to 
by a sequence-set index record; used by VSAM for 
distributing free space and for placing a sequence-set index 
record adjacent to its data. 


control interval: A fixed-length area of auxiliary-storage space 
in which VSAM stores records and distributes free space. It is 


the unit of information transmitted to or from auxiliary 
storage by VSAM, some integer multiple of blocksize. 


CRA: Catalog recovery area. An entry-sequenced data set 
that exists on each volume owned by a recoverable catalog, 
including the catalog volume itself. The CRA contains 
self-describing records as well as duplicates of catalog records 
that describe the volume. 


data integrity: Preservation of data or programs for their 
intended purpose. As used in this publication, the safety of 
data from inadvertent destruction or alteration. 


data record: A collection of items of information from the 
standpoint of its use in an application and not from the 
standpoint of the manner in which it is stored. ( See also 
stored record.) 


data security: Prevention of access to or use of data or 
programs without authorization. As used in this publication, 
the safety of data from unauthorized use, theft, or purposeful 
destruction. 


data set: The major unit of data storage and retrieval in the 
operating system, consisting of data in a prescribed 
arrangement and described by control information to which 
the system has access. As used in this publication, a collection 
of fixed- or variable-length records in auxiliary storage, 
arranged by VSAM in key sequence or in entry sequence. 

( See also key-sequenced data set.) 


data space: A storage area defined in the volume table of 
contents of a direct-access volume for the exclusive use of 
VSAM to store data sets, indexes, and catalogs. 


direct access: The retrieval or storage of data by a reference to 
its location in a data set rather than relative to the previously 
retrieved or stored data. 


extent: A continuous space allocated on a direct-access 
storage volume, reserved for a particular data space or data 
set. 


extension record: The continuation of a catalog record that 
contains set-of-fields pointers and their sets of fields. 
Set-of-fields pointers in an extension record always point to 
sets of fields within the extension record. The extension 
record’s extension pointer can point to a control interval that 
contains part of a set of fields too large to fit in the extension 
record (horizontal extension). 


external procedure: A procedure that can be called by any 
other VSAM procedure; a procedure whose name is in the 
module’s (assembler listing) *“‘external symbol dictionary”. 


field: In a record or a control block, a specified area used for 
a particular category of data or control information. 


free space: ( See distributed free space.) 


generation data group: A collection of data sets that are kept in 
chronological order; each data set is called a generation data 
set. 


generic key: A high-order portion of a key, containing 
characters that identify those records that are significant for a 
certain application. For example, it might be desirable to 
retrieve all records whose keys begin with the generic key AB, 
regardless of the full key values. 


group code: ( See type code.) 
group occurrence: ( See set of fields.) 


group occurrence pointer: ( See set-of-fields pointer.) 
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horizontal extension: An extension record pointed to by a 
catalog record’s extension field. ( See also vertical extension.) 


horizontal pointer: A pointer in an index record that gives the 
location of another index record in the same level that 
contains the next key in collating sequence; used for keyed 
sequential access. 


index: As used in this publication, an ordered collection of 
pairs, each consisting of a key and a pointer, used by VSAM 
to sequence and locate the records of a key-sequenced data 
set; organized in levels of index records. ( See also index 
level, index set, and sequence set.) 


index entry: A key and a pointer paired together, where the 
key is the highest key (in compressed form) entered in an 
index record or contained in a data record in a control 
interval, and the pointer gives the location of that index 
record or control interval. 


index set: The set of index levels above the sequence set. The 
index set and the sequence set together comprise the index. 


index upgrade: The process of reflecting changes made to a 
base cluster in its associated alternate indexes. 


internal procedure: A procedure that can be called only by 
other procedures within the module. (See also external 
procedure.) 


key: One or more characters within an item of data that are 
used to identify it or control its use. As used in this 
publication, one or more consecutive characters taken from a 
data record, used to identify the record and establish its order 
with respect to other records. ( See also key field and generic 
key.) 


key field: A field located in the same position in each record 
of a data set, whose contents are used for the key of a record. 


key sequence: The collating sequence of data records, 
determined by the value of the key field in each of the data 
records. May be the same as, or different from, the entry 
sequence of the records. 


key-sequenced data set: A data set whose records are loaded in 
key sequence and controlled by an index. Records are 
retrieved and stored by keyed access or by addressed access, 
and new records are inserted in the data set in key sequence 
by means of distributed free space. Relative byte addresses of 
records can change. 


mass storage volume: The unit of storage in the Mass Storage 
System. 


master catalog: A key-sequenced data set with an index 
containing extensive data-set and volume information that 
VSAM requires to locate data sets, to allocate and deallocate 
storage space, to verify the authorization of a program or 
operator to gain access to a data set, and to accumulate usage 
statistics for data sets. 


pagespace: An amount of direct-access device space that can 
be used to contain temporary data sets. A pagespace is 
conceptually (and identified to the OS/VS2 system as) an 
entry-sequenced VSAM data set. 


password: A unique string of characters stored in a catalog 
that a program, a computer operator, or a terminal user must 
supply to meet security requirements before a program gains 
access to a data set. 


path: A named, logical entity composed of one or more 
clusters (an alternate index and its base cluster, for example). 
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pointer: An address or other indication of location. For 
example, an RBA is a pointer that gives the relative location 
of a data record or a control interval in the data set to which 
it belongs. (See also horizontal pointer and vertical pointer.) 


portability: The ability to use VSAM data sets with different 
operating systems. Volumes whose data sets are cataloged in 
a user catalog can be demounted from storage devices of one 
system, moved to another system, and mounted on storage 
devices of that system. Individual data sets can be transported 
between operating systems using Access Method Services. 


prime index: The index component of a key-sequenced data 
set that has one or more alternate indexes. 


prime key: The key of reference for a base cluster, 
key-sequenced data set when it was loaded. 


procedure: A functional unit of VSAM code that is entered 
only at one entry point and exits at the end of the procedure 
(the last line of the procedure’s code). The procedure can call 
(transfer control, with a return to the procedure expected) 
other procedures within the module (internal calls) and can 
call other procedures in other VSAM modules (external 
calls). (See also internal procedure and external procedure.) 


qualified DSNAME: A data set name in the form A:B.C. 


RBA: Relative byte address. The displacement of a data 
record or a control interval from the beginning of the data set 
to which it belongs; independent of the manner in which the 
data set is stored. 


record: ( See index record, data record, stored record.) 
relative byte address: ( See RBA.) 


relative DSNAME: A data set name in the form ““dsname(n)” 
that identifies a generation data set. 


relative record data set: A data set whose records are loaded 
into fixed-length slots. 


relative record number: A number that identifies not only the 
slot, or data space, in a relative record data set but also the 
record occupying the slot. 


reusable data set: A VSAM data set that can be reused as a 
work file regardless of its old contents. 


security: ( See data security.) 


segment: The portion of a stored record contained within a 
control interval. A stored record may consist of one or more 
segments (see spanned record). 


shared resources: A set of functions that permit the sharing of 
a pool of I/O-related control blocks, channel programs, and 
buffers among several VSAM data sets open at the same 
time. 


spanned record: A logical record whose length exceeds control 
interval length, and as a result, crosses, or spans, one or more 
control intervals within a single control area. 


sequence set: The lowest level of the index of a key-sequenced 
data set; it gives the locations of the control intervals in the 
data set and orders them by the key sequence of the data 
records they contain. The sequence set and the index set 
together comprise the index. 


set of fields: A group of catalog record fields that contain 
related information. Sets of fields are referred to in the code 
as “group occurrences’ or “GOs”. 


set-of-fields pointer: A field used to identify and locate a set of 
fields by its displacement from the beginning of the record’s 


sets of fields (the set of fields is in the same control interval as 


the set-of-fields pointer) or by a control interval number (the 
set of fields pointer is in the base catalog record or its 
extension and the set of fields is in an extension record). 
Set-of-fields pointers are grouped by type code and are in 
ascending sequence by sequence number. Set-of-fields 
pointers are referred to in the code as “‘group occurrence 
pointers” or ““GOPs”. 


stored record: A data record, together with its control 
information, as stored in auxiliary storage. 


type code: A code that identifies the set-of-fields type. Type 
codes are referred to in the code as ‘‘group codes” or “GCs”. 
( See “Field Name Dictionary” for a list of type codes.) 


upgrade set: All the alternate indexes that VSAM has been 
instructed to update whenever there is a change to the data 
component of the base cluster. 


user catalog: A catalog used in the same way as the master 
catalog, but optional and pointed to by the master catalog, 
and also used to lessen the contention for the master catalog 
and to facilitate volume portability. 


vertical extension: An extension record pointed to by a 
set-of-fields pointer in the object’s base catalog record or its 
horizontal extension. (See also base catalog record and 
horizontal extension.) 
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For additional information about any subject listed 
in the index, refer to the publications listed under 
the same subject in OS/VS2 Master Index of Logic, 
GC28-0694. 
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abbreviations 387 
absolute dsname 69 
removal of 161 
ACB control block 
description 341 
mapped by IFGACB macro 379 
access method control block (ACB) 341 
access method control block structure block (AMCBS) 344 
access method data statistics block (AMDSB) 344 
Access Method Services and OS/VS2 catalog management 
processing 106 
(see also OS/VS Access Method Services) 
action macro instructions 380 
adding a new set of fields to a catalog record 99 
ADDREC macro 380 
issued by 
DEFINE CATALOG processing 123 
DEFINE CLUSTER processing 113 
alias catalog record 
its association (alias) set of fields description and 
format 308 
its association (user catalog or nonVSAM) set of fields 
description and format 307 
building 131 
description and format 306 
allocating more space to a data set 77 
extent descriptor for 79 
from a nonunique data space 91 
and sequence set with data 79 
allocating space 
part of a data space’s Suballocate processing 196 
to a VSAM data set or key range 77 
ALTER processing 138 
altering a RACF indicator 226.1 
alternate dsnames (aliases) 21 
identifying a user’s catalog or nonVSAM data set 
with 130 
removing a data set’s or catalog’s 160 
alternate index catalog record 
association set of fields 296 
description and format 294 
password set of fields 296 
AMCBS control block 
description 344 
mapped by AMCBS maco 377 
AMCBS macro 377 
(see also AMCBS control block) 344 
AMDSSB control block 
description 344 
mapped by IDAAMDSB macro 378 
AMDSSB set of fields 
description 278 
used in data catalog record 287 
used in index catalog record 287 
amendments, summary of 11 
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assignment of 
candidate volumes 
after the data set or catalog has been created 143 
during DEFINE CLUSTER processing 115 
catalog control intervals 
contiguous, more than one: IGGPAOCI 
processing 211 
CRA control intervals 222 
one, for an extension catalog record: IGGPAXCI 
processing 212 
RPL to catalog management requests 51 
association set of fields 
alias association 
in alias catalog record 307 
placement of 131 
in nonVSAM catalog record 304 
in user-catalog catalog record 313 
cluster association 
in data catalog record 288 
in index catalog record 288 
data or index association 
in cluster catalog record 293 
description 278 
GDG base association 
in nonVSAM catalog record 305 
illustrated 279 
nonVSAM association 
in alias catalog record 307 
in GDG base catalog record 311 
user catalog association 
in alias catalog record 307 
available-space map: LSPACE processing 92 


B 


backing up acatalog 26 
base catalog record 
creation of 
(see entries for DEFINE processing) 
retrieval of 44 
bit manipulation routine, used during Suballocate 
processing 89 
building VSAM objects 
(see also entries for DEFINE processing) 
absolute dsname for a generation data set 69 
alias catalog record 130 
alternate index 116 
available space report 92 
catalog 122 
catalog recovery area 126 
cluster 112 
generation data group base catalog record 132 
path 120 
bypassing password checking 53 
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CALLSF macro 380 
CALL EXIT macro 380 
call VSAM Record Management: IGGPXIO processing 215 
calls, by procedures 
(see the Procedure Calls Directory) 241 
CAMLSTD control block processing 39 
candidate volume processing 89 
and DEFINE SPACE processing 135 
and SUBALLOCATE processing 89 
deletion of a data set’s candidate volumes 157 
catalog 
auxiliary work area (CAXWA) 346 
communication area(CCA) 348 
register save area 382 
control interval 19 
assignment of 211,212 
control blocks for an open catalog 338 
control record (CCR) 282 
control volume list (CTGCV) 360 
controller processing 38 
converting volumes to or from mass storage 165 
CONVERTYV processing 164,200 
creation of: DEFINE CATALOG processing 122 
initial processing 110 
CVOL-type 49 
debug aid 381 
deletion of: DELETE CATALOG processing 158 
field name dictionary 327 
format 18 
format and description 282 
high-key range of the catalog 18 
identifier (in the CTGPL) 
dsname 45 
equal to zero 47 
low-key range of the catalog 19 
names/volume area (CTGCV) 360 
parameter list (CTGPL) 363 
parts of 19 
recovery 25 
recovery area 25 
(see also CRA) 
summary of 18 
unload/reload 26 
update and rewrite 213 
updated when an extension record is obtained 101 
volume list (CTGVL) 366 
work area (CTGWA) 367 
catalog management 
control blocks 340 
error codes: set in CCAPROB 384 
I/O functions 206 
OS/VS2 43 
overview: Diagram AA 32 
overview (OS/VS2) 42 
procedure called-by directory 263 
procedure calls directory 241 
procedure name abbreviations, used in program 
organization figures 167 
processing 160 
program organization contents: Figure 7 171 
RACF functions 206 
table of contents 41 
summary of 13 
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catalog management services processing 
overview 106 
program organization figure 198 
catalog record 
alias 306 
alternate index 294 
associations, illustrated 279 
catalog control record (CCR) 282 
cluster 291 
contents, retrieval of: LISTCAT processing 144 
control 282 
CRA 323-327 
data 284 
deletion: IGGPPDE processing 210 
extension record for 95,101 
description and format 321 
format of 321 
field’s value 
modifying 98 
modifying (with ALTER) 138 
obtaining 94 
free 283 
free control intervals, described inthe CCR 101 
general format 278 
generation data group (GDG) base 308 
index 284 
information 
modification of: UPDATE processing 74 
modification of: ALTER processing 138 
retrieval of: LOCATE processing 56 
locating fields ina 280 
modifying a field’s value 98 
nonVSAM 302 
obtaining a field’s value 94 
path 297 
recovery area 323-327 
retrieval: IGGPGET processing 207 
set of fields, types of 278 
that describe the catalog 21 
true name 282 
types of 19 
upgrade 300 
user catalog 311 
volume 314 
write (add): IGGPPAD processing 209 
write (update): IGGPPUPC processing 208 
CATLG macro 160,380 
CATPROB macro 380 
CAXWA control block 
description 346 
mapped by IGGCAXWA macro 379 
CCA control block 
description 348 
mapped by IGGCCA macro 379 
register save area 382 
CCAPROB field 384 
checking a password 53 
checking security authorization 52 
closing the master catalog 35 
cluster, creation of 112 
initial processing 110 
cluster catalog record 
association (data and index) set of fields description and 
format 293 
format 291 
password set of fields format 293 


COMB macro 380 
(see also combination name processing) 325 
combination name processing 
during LOCATE processing 59 
during UPDATE processing 75 
resolution of 329 
conditional processing 
during LOCATE processing 57 
during UPDATE processing 75 
connecting another system’s OS/VS2 user catalog to your 
system’s master catalog: IMPORT processing 129 
control block interrelationships 
catalog management control blocks 340 
open catalog control blocks 338 
VSAM control blocks that describe a catalog 339 
control blocks 
descriptions 341 
OS/VS 
(see OS/VS2 Data Areas) 
control interval 
Note: all control blocks used in OS/VS2 catalog 
management processing are indexed by abbreviation 
and name. 
recorded by the generalized trace facility 382 
assignment of 
contiguous, more than one: IGGPAOCI 
processing 211 
CRA 222 
one, for an extension catalog record: IGGPAXCI 
processing 212 
password 24 
controller (catalog) processing 38 
converting a relative dsname to an absolute dsname 69 
converting a volume to or from mass storage 165 
CONVERTYV processing 164,200 
copying the catalog 24,26 
CRA (see also catalog, recovery area) 
assigning control intervals 222 
catalog control record 326 
cluster record 325 
data extension record 
description and format 326 
volume information set of fields 327 
data record 
AMDSSB set of fields 324 
association set of fields 324 
description and format 324 
volume information set of fields 324 
free record 323 
I/O exit 224 
opening 221 
orienting to 220 
record processing 
adding 218 
deleting 219 
updating 217 
creating VSAM objects/catalog records 
alternate index 116 
catalog 
master 16 
user: DEFINE CATALOG processing 122 
initial processing 110 
catalog recovery area 126 
cluster: DEFINE CLUSTER processing 112 
initial processing 110 
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data set 
generation: DEFINE NONVSAM processing 128 
nonVSAM: DEFINE NONVSAM processing 128 
VSAM: DEFINE CLUSTER processing 112 
data space: DEFINE SPACE processing 134 
OS/VS DADSM processing required 136 
generation data group: DEFINE GDGBASE 
processing 132 
generation data set: DEFINE NONVSAM 
processing 71,128 
AMDSSB in the catalog’s cluster record 123 
association (GDG base) set of fields 123 
nonVSAM data set: DEFINE NONVSAM 
processing 128 
path 120 
RACF-protected 226.3 
cross-reference aids 374 
CTGCYV control block 
description and format 360 
mapped by IEZCTGCV 378 
CTGFL control block 
description 360 
mapped by IEZCTGFL macro 379 
multitype 145 
used during 
LISTCAT processing 145 
LOCATE processing 71 
MODIFY processing 99 
SUPERLOCATE processing 63 
UPDATE processing 75 
CTGEFLs for tests 57,75 
CTGFYV control block 
description 361 
mapped by IEZCTGFV macro 379 
CTGPL control block 
description 363 
mapped by IEZCTGPL macro 379 
CTGVL control block 
description and format 366 
mapped by IEZCTGVL macro 379 
CTGWA control block 
description and format 367 
mapped by IEZCTGWA macro 379 
CVOL-type catalog 49 


D 


DADSM (OS/VS) 
allocate routine, building the OS/VS2 catalog 123 
DELETE processing 153 
format |: identifier 
DEFINE SPACE processing 135 
DELETE processing 151 
format 3: extension 
DELETE processing 151 
format 4: VTOC 
DEFINE SPACE processing 135 
DELETE SPACE processing 157 
mapped by F4DSCB macro instruction 377 
format 5 
DELETE processing 151 
SCRATCH processing and 151 
(see OS/VS2 DADSM Logic) 
data areas section 275 
alias catalog record format 306 
alternate index catalog record format 294 
catalog control record (CCR) format 282 
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catalog record descriptions 275 
catalog management control block descriptions 341 
access method control block (ACB) 341 
access method control block structure block 
(AMCBS) 344 
access method data statistics control block 
((AMDSB) 344 
catalog auxiliary work area 346 
catalog communications area (CCA) 348 
catalog parameter list (CTGPL) 363 
field parameter list (CTGFL) 360 
field vector table (CTGFV) 361 
private catalog control block (PCCB) 368 
request parameter list (RPL) 369 
cluster catalog record format 291 
control block interrelationships 337 
data and index catalog record format 284 
extension catalog record format 321 
field name dictionary 327 
free catalog record format 283 
generation data group (GDG) base catalog record 
format 308 
nonVSAM catalog record format 302 
path catalog record format 297 
true name catalog record format 282 
upgrade catalog record format 300 
user-catalog catalog record format 311 
volume catalog record format 314 
summary of 3,275 
data areas 
OS/VS 
(see also OS/VS2 Data areas) 
Note: all data areas used in OS/VS2 catalog management 
processing are indexed by abbreviation and name. 
data catalog record 
AMDSSB set of fields format 287 
association (cluster) set of fields format 288 
format and description 284 
header fields 284 
password set of fields format 290 
volume information set of fields 288 
data set 
creation of 
generation 132 
nonVSAM 128 
VSAM 110 
deletion of 148 
directory entry set of fields 320 
expiration date: during DELETE processing 149 
volumes, list the: SUPERLOCATE processing 62 
data set control block (see DSCB control block) 
data space 
allocating part of the space to a VSAM object 88,196 
containing only one VSAM object (unique) 77 
creation of 134 
deletion of 156 
extent for 77 
group set of fields format 317 
initialization of 134 
listing the contents of: GENDSP processing 60 
shared by more than one VSAM object (nonunique) 77 
debug aid 381 
DEFINE processing 204 
AIX (to create an alternate index) 116 
ALIAS (to create an alias catalog record) 130 
CATALOG (to create a user's catalog) 110,122,204 
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CLUSTER (to create a VSAM cluster) 110,112,204 
additional processing for key ranges 115 
additional processing for key-sequenced data set 113 
AMDSSB in the cluster catalog record 113 
assignment of candidate volumes 115 
sequence set with data 115 

CRA (to create a catalog recovery area) 126 

create an OS/VS2 catalog or VSAM data set 110 

define a RACF-protected object 110,199,226.3 

GDGBASE (to create a generation data group catalog 

record) 132 
NONVSAM (to define a nonVSAM data set in a VSAM 
catalog) 128 

PATH (to create a path) 120 

SPACE (to create a VSAM data space onavolume) 134 
OS/VS DADSM_ 136 

definitions of terms used in the book 389 
DELETE macro 380 
(see also DADSM: delete processing) 153 
DELETE processing (to remove a cluster or nonVSAM data 
set’s catalog records) 148 

AIX (to remove an alternate index) 148 

ALIAS (to remove an alias catalog record) 160 

CATALOG (to erase a user catalog and remove its 

catalog record from the master catalog) 158 

CLUSTER (to remove acluster) 148 

delete partially defined RACF cluster 226.4 

delete RACF profile 153,199,201 

for a catalog record: IGGPPDE processing 210 

for a catalog record’s set of fields 103,192 

GDGBASE (to remove a generation data group base 

catalog record) 162 

NONVSAM (to remove a nonVSAM data set) 148 

PATH (to remove a path) 148 

SPACE (to release all VSAM data spaces ona 

volume) 156 
deleted control intervals 
free, described in the catalog control record (CCR) 283 
in the catalog 101 
deleting candidate volume assignments to a ddataset 149 
DELREC macro 380 
derived volume-catalog-record information 

data set information 320 

data space information 319 

volume information 317 

Diagnostic Aids section 373 
catalog communications area (CCA) register save 
area 382 

catalog debug aid 381 

error return codes 384 

generalized trace facility 382 

macro instructions 377 
that define data areas 377 
that generate executable code 380 
usage table description 376 

messages 376 

microfiche cross-reference aids 374 

summary of 3,296,374 

symbolic name usage table description 374 

diagrams, list of 9 
DICT macro 380 

(see also field name dictionary) 327 

dictionary entry 

example of 336,337 

format 327 


direct-access device space management (DADSM) 
OS/VS 
(see OS/VS2 DADSM Logic) 
VSAM 
(see DEFINE SPACE, DELETE SPACE, and 
Suballocate) 
Directory section 227 
external procedure names 234 
load modules and their contents 233 
module name 227 
procedure called-by 263 
procedure calls 241 
summary of 3 
displaying fields of a catalog 146 
DSCB control block 
format 1 (identifier) 
and ALTER processing 139 
format 4 (VTOC) 
and ALTER processing 139 
and CONVERTYV processing 165 
and DELETE processing 151,157 
and UPDATE-Extend processing 77 
dsname as a search argument 45 


E 


entry-point-name directory (external procedure name 
directory) 233 
ERASE processing 210 
erasing an OS/VS2 catalog 159 
error codes 
alphabetic list of symbolic names for 386 
catalog management, set in CCAPRDB 384 
error recovery 27 
exit routine, 1/O 224 
extending a data set 77 
extending a key-range data set 77,79 
extension Catalog record 
assigning a control interval for use by: IGGPAXCI 
processing 212 
description and format 321 
extent descriptor, and Suballocate processing 91 
external procedure directory 234 
EXTRACT processing 174 


F 


field name dictionary 327 
combination field names 329 
dictionary entry format 327 
entries, list of 329 
entry examples 336,337 
set of fields type codes 329 
field parameter list (CTGFL) 360 
field vector table (CTGFV) 361 
fields, locating in a catalog record 280 
figures, list of 9 
FILE option 
ALTER command 138 
DELETE command 148 
force delete RACF catalog entries 226.5 
free (unused) catalog record 283 
free control intervals in the catalog 101 
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G 


GENDSP processing 60 
LOCATE processing 56 
general format of catalog records 276,277 
generalized trace facility 382 
generation data group (GDG) base catalog record 
association (nonVSAM) set of fields format and 
description 311 
description and format 308 
generation data groups 22 
creating: DEFINE GDGBASE processing 132 
removing: DELETE GDGBASE processing 162 
generation data set 
dsname for 72 
locating a 73 
generic name, LOCATE based ona 70 
GET processing 207 
get-field-value processing 93 
glossary section 387 
summary of 3 


graphic symbols used in method of operation diagrams 30 


GTF (generalized trace facility) 382 


H 


header fields, retrieval of 95 
high-key range of the catalog 18 
true name catalog record format 282 


I 


IBM publications referenced, list of 3,4 
IDAAMDSB macro 378 

(see also AMDSB control block) 344 
IDAPCTT macro 378 

(see also PCTT control block) 369 
IEFPCCB macro 378 

(see also PCCB control block) 368 
IEZCTGCV macro 378 

(see also CTGCV control block) 360 
IEZCTGFL macro 378 

(see also CTGFL control block) 360 
IEZCTGFV macro 378 

(see also CTGFV control block) 361 
IEZCTGPL macro 379 

(see also CTGPL control block) 363 
IEZCTGVL macro 379 

(see also CTGVL control block) 366 
IEZCTGWA macro 379 

(see also CTGWA control block) 367 
IFGACB macro 379 

(see also ACB control block) 341 
IFGRPL macro 379 

(see also RPL control block) 369 
IGGCAXWA macro 379 

{see also CAXWA control block) 346 
IGGCCA macro 379 

(see also CCA control block) 348 
IGGMCDCL macro 379 
IGGMCMDM macro 379 
IGGMCMWA macro 379 
IGGMCTRC macro 379 
IGGMDRWA macro 379 
IGGMEND macro 380 
IGGMF4WA macro 380 
IGGMGVO macro 379 
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(see also volume information set of fields) 288 
IGGMODUL macro 380 
IGGMPROC macro 380 
IGGMSAWA macro 379 
IGGMUPDE macro 379 
IGGMVEDC macro 379 
IGGMZLOC macro 379 
IGGPxxxx (typical external procedure name) 234 
See the External Procedure Directory, page 234, for: 
e The name of the procedure’s module 
e The procedure’s descriptive name 
« The method of operation diagrams and program 
organization figures that describe the procedure 
IGGSHWPL macro 379 
IGGOCLxx (typical module name) 
called by 

See the Procedure Called-By Directory, page 263, fora 
list of procedures that transfer control to the external 
procedures in the module. 

See the External Procedure Directory, page 234, to 
find the method of operation diagram and program 
organization figure that describes a specific 
procedure. 

calls 

See the Procedure Calls Directory, page 241, for a list 
of procedures that the module’s procedures transfer 
control to. 

See the External Procedure Directory, page 234, to 
find the method of operation diagram and program 
organization figure that describes a specific 
procedure. 

described 

See the Module Directory, page 227, to find the 
method of operation diagrams and program 
organization figures that describe the module and its 
procedures. 

external procedures 

See the Module Directory, page 237, for a list of the 
module’s external procedures. 

loaded in 

See Module Packaging, page 233, for a list of modules 
contained in each load module. 

other information 

See Diagnostic Aids, page 373, for a description of the 
many different kinds of information about the 
module that might help you diagnose and correct a 
problem. 

IHADCB macro 379 
IHADCBDF macro 379 
IHARB macro 379 
IHASRB macro 379 
IKJPSCB macro 379 
IKJTCB macro 379 
Illustrations 9 
IMPORT processing 129 
index catalog record 
AMDSSB set of fields format 287 
association: cluster set of fields format 288 
format and description 284 
header fields 284 
password set of fields format 2909 
volume information set of fields format 288 
initializing a VSAM data space: DEFINE SPACE 
processing 134 
input/output functions of catalog management 174 
insert a new set of fields: IGGPADGO processing 186 
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introduction section 13 
summary of 3 
introduction to OS/VS2 catalog management 14 
I/O functions of catalog management 206 
I/O supervisor control block, mapped by IECDIOSB 
macro 378 


J 


job control language 
JOBCAT=dsname 14 
searching the catalogs 47 
user’s catalog 37 
STEPCAT=dsname 14 
searching the catalogs 47 
user's catalog 37 
(See OS/VS2 JCL) 
JOBCAT and STEPCAT statements 14 
JOBCAT=dsname—JCL DD parameter 14 
JSCB and searching the OS/VS2 catalogs 47 


L 


levels of password protection 23 
LISTCAT processing 144 
restrictions 145 
listing (printing) 
catalog record, contents of: LISTCAT processing 144 
restrictions 145 
a data set’s volumes: SUPERLOCATE processing 62 
data space, contents of: GENDSP processing 60 
load modules 227 
LOCATE processing 56 
based on a generic dsname 70 
called by 
end of volume processing 56 
open processing 56 
and the caller’s workarea 58 
for combination names 58 
conditional retrieval of fields 56 
entry conditions for 56 
and EXTRACT processing 174 
and GENDSP processing 56 
to retrieve 
catalog information 56 
fields in a catalog record 278 
a generation data set’s catalog record 72 
an object’s base catalog record 45,51 
special processing for 56 
and SUPERLOCATE processing 56 
low-key range of acatalog 19 
LSPACE processing 92 


M 


macro instructions 377 
that define data areas 377 
that generate executable code 380 
usage table 
example of 376 
how to read 375 
Mapping macro instructions 377 
mass storage 
converting to or from 164,200 
relative to system, illustrated 13 


C 


master catalog 
connecting another system’s user catalog to: IMPORT 
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